Logging einrichten

Auf dieser Seite finden Sie Informationen dazu, wie Cloud Network Insights in AppNeta eingebunden wird, um Alarme zu generieren, und wie diese Alarme zur Analyse, Ansicht und Erstellung von Benachrichtigungsrichtlinien an Google Cloud gesendet werden.

Logging- und Benachrichtigungsaufgaben werden zwischen Google Cloud und AppNeta aufgeteilt. Mit dem Logging von Cloud Network Insights wird erfasst, wenn die von Monitoring Points erfassten Messwerte die Schwellenwerte überschreiten, die Sie mit Alarmregeln in AppNeta konfigurieren.

Erstellen Sie Alarme und Alarmregeln in AppNeta, um Alarmprotokolle zu generieren. Alarm- und Ereignisprotokolle werden dann in Cloud Logging exportiert. Anschließend können Sie Benachrichtigungsrichtlinien verwenden, um Benachrichtigungen zu senden, wenn ein Netzwerkvorfall auftritt.

Hinweis

Sie müssen einen Monitoring Point bereitstellen, bevor Sie Alarmregeln erstellen können.

Alarme in AppNeta

Alarme und Alarmregeln werden in AppNeta erstellt. Alarme informieren Sie, wenn ein Problem in Ihrem Netzwerk vorliegt. Wenn ein von Ihnen erfasster Messwert, z. B. die Latenz, innerhalb eines bestimmten Intervalls einen festgelegten Schwellenwert überschreitet, ist dies ein Verstoß gegen die Alarmregel. Sie können festlegen, dass ein Alarm nach einem einzelnen Verstoß oder nach mehreren Verstößen innerhalb eines bestimmten Intervalls ausgelöst wird.

Wenn die Latenz beispielsweise innerhalb von 3 Minuten zweimal 160 ms überschreitet, können Sie den Alarm so einstellen, dass eine Warnung ausgelöst wird. Dieser Alarm wird als Protokoll an Google Cloud gesendet. Sobald das Log in Cloud Logging eingeht, können Sie eine Benachrichtigung dazu senden und Ihr Team informieren.

Weitere Informationen zu Alarmen finden Sie in der AppNeta-Dokumentation unter Alarms Overview oder Alarms – Best Practices.

Alarmregeln in AppNeta erstellen

Erstellen Sie Alarmregeln, die Leistungsschwellenwerte definieren.

  1. Öffnen Sie die Google Cloud Console und rufen Sie Network Intelligence > Cloud Network Insights > Benachrichtigungsrichtlinien auf.

    Zu „Benachrichtigungsrichtlinien“

  2. Klicken Sie auf Alarmregeln erstellen, um die Seite Alarmregel bearbeiten in AppNeta zu öffnen.

  3. Definieren Sie Regeln, die Messwerte, Schwellenwerte, Strategien für Verstöße und den Schweregrad angeben. Sie können Standardregeln verwenden oder anpassen.

Nachdem ein Alarm ausgelöst wurde, wird das Alarmprotokoll an Cloud Logging gesendet. Nachdem das Log an Google Cloudgesendet wurde, können Sie zu Cloud Network Insights wechseln und Ihre Benachrichtigungsrichtlinien festlegen.

Weitere Informationen zum Erstellen von Alarmregeln finden Sie in der AppNeta-Dokumentation unter Alarm Rules.

Logs in Google Cloudansehen

Cloud Network Insights exportiert detaillierte Logs in Cloud Logging, damit Sie die Netzwerkleistung und wichtige Ereignisse analysieren und Fehler beheben können. Sie können mit dem Log-Explorer auf diese Logs zugreifen.

  1. Rufen Sie in der Google Cloud Console die Seite Log-Explorer auf.

    Zum Log-Explorer

  2. Abfragen erstellen, um bei relevanten Informationen benachrichtigt zu werden.

Cloud Network Insights-Logs verwenden eine der folgenden Log-IDs:

  • Alarmprotokolle: networkmanagement.googleapis.com/insights_alarm
  • Ereignisprotokolle: networkmanagement.googleapis.com/insights_event

Weitere Informationen finden Sie unter Abfragen mit der Logging-Abfragesprache erstellen und speichern.

Preise

Alle Cloud Network Insights-Logs werden in Cloud Logging geschrieben. Für diesen Dienst fallen keine separaten Gebühren von Cloud Network Insights an. Diese Logs können jedoch je nach Größe der geschriebenen und gespeicherten Logs zu zusätzlichen Speicherkosten führen.

Informationen zu den Preisen für Cloud Logging finden Sie unter Preise für Google Cloud Observability: Cloud Logging.

Protokolldetails

Die spezifischen Details für jeden Logtyp sind im Feld jsonPayload enthalten. Es gibt jedoch mehrere andere Standardfelder vom Typ „LogEntry“, die für die Abfrage und das Verständnis der Logs entscheidend sind.

Alarmprotokolle

  • Log-ID: networkmanagement.googleapis.com/insights_alarm
  • Ausgelöst: Wird generiert, wenn die Bedingungen einer Alarmregel erfüllt sind.
  • Ressourcenlabels: Beschreibt die überwachte Ressource, die mit dem Log verknüpft ist. Dazu zählen:
    • type: Der Ressourcentyp, der einer der folgenden sein kann:
      • networkmanagement.googleapis.com/MonitoringPoint
      • networkmanagement.googleapis.com/NetworkPath
      • networkmanagement.googleapis.com/WebPath
    • labels: Schlüssel/Wert-Paare, die die spezifische Ressourceninstanz identifizieren, z. B. resource_container (Projekt-ID), location, network_monitoring_provider_id und path_id oder monitoring_point_id.
  • Wichtige JSON-Felder: Alarmprotokolle enthalten Informationen zu ausgelösten Alarmen.
  • Schweregradzuordnung: Der Schweregrad wird in AppNeta und Google Cloudunterschiedlich erfasst.
    AppNeta-Schweregrad Schweregrad von Google Cloud-Logs
    Kritisch CRITICAL
    Schwerwiegend FEHLER
    Geringfügig WARNUNG
    Warnung HINWEIS

Alarmprotokollfelder

Das jsonPayload eines Alarm-Logs enthält die folgenden Felder.

Feld Typ Beschreibung
alarm_id String Die eindeutige Kennung für den Alarm in AppNeta.
alarm_severity enum Der Schweregrad des Alarms. Kann CRITICAL, MAJOR, MINOR oder WARNING sein.
alarm_type enum Der Typ des Alarms. Der Typ QUALITY_OF_SERVICE wird unterstützt.
cleared_reason String Der Grund, warum der Alarm gelöscht wurde. Wird nur generiert, wenn state = „CLEARED“ (andernfalls weggelassen oder null). Gängige Stringwerte sind alarm-rule-no-longer-violated, stale, rule-deleted und duplicate.
cleared_time timestamp Der Zeitpunkt, zu dem der Alarm gelöscht wurde. Dieses Feld ist leer, wenn das Alarmprotokoll den Status RAISED oder UPDATED hat.
description String Eine menschenlesbare Beschreibung des Alarms.
first_violation_time timestamp Der Zeitpunkt, zu dem die Alarmbedingung zum ersten Mal verletzt wurde.
item Objekt Die mit dem Alarm verknüpfte Entität. Weitere Informationen finden Sie unter Gängige Elementstrukturen.
noise_conditions String-Array Gibt an, welche Rauschfilterbedingungen diesen Alarm für das angegebene Regel- und Elementpaar ausgelöst haben. Alarme werden sowohl anhand eines 24-Stunden-Häufigkeitsschwellenwerts als auch eines kurzfristigen Burst-Fensters ausgewertet.

Kann einen oder beide der folgenden Werte enthalten:

  • frequent-detection: Wird ausgelöst, wenn die Anzahl der Alarme für dasselbe Element den 24-Stunden-Schwellenwert erreicht (Standard: 5 Alarme).
  • burst-detection: Wird ausgelöst, wenn innerhalb des konfigurierten Zeitfensters mehrere Alarme auftreten (Standard: mehr als 1 Alarm pro 60 Minuten).

Gibt ein leeres Array zurück oder wird vollständig weggelassen, wenn der Alarm nicht als laut eingestuft wird.

provider_link String Ein Hyperlink zum Alarm in der AppNeta-Benutzeroberfläche.
raised_time timestamp Der Zeitpunkt, zu dem der Alarm ausgelöst wurde.
receiveTimestamp String Die Zeit, zu der der Alarm in Google Clouderstellt wurde.
rule String Der Name der Alarmregel, die den Alarm ausgelöst hat.
state enum Der Status des Alarms. Kann RAISED, UPDATED (die Alarmdetails wurden in AppNeta aktualisiert, aber noch nicht gelöscht) oder CLEARED sein.
timestamp String Der Zeitpunkt, zu dem der Alarm in AppNeta erstellt wurde.

Ereignisprotokolle

  • Log-ID: networkmanagement.googleapis.com/insights_event
  • Trigger: Wird generiert, wenn eine strukturelle Änderung auftritt (z. B. Route Change, MTU Change oder Monitoring Point Offline).
  • Schweregrad: Immer INFO.
  • Wichtige JSON-Felder: Ereignisprotokolle enthalten Informationen zu ausgelösten Ereignissen.

Felder im Ereignisprotokoll

Das jsonPayload eines Ereignisprotokolls enthält die folgenden Felder.

Feld Typ Beschreibung
event_detail Objekt Details zum Ereignistyp. Das kann route_change_event, mtu_change_event, qos_change_event oder forwarding_loss_clear_event sein. Für Ereignisse ohne weitere Details wird ein leeres Objekt zurückgegeben. Weitere Informationen finden Sie unter Felder für Ereignisdetails.
event_id String Die eindeutige Kennung für dieses Ereignis.
event_type enum Art des Ereignisses. Kann MONITORING_POINT_OFFLINE, MONITORING_POINT_ONLINE, ROUTE_CHANGE, MTU_CHANGE, QOS_CHANGE oder FORWARDING_LOSS_CLEAR sein.
item Objekt Die mit dem Ereignis verknüpfte Entität. Weitere Informationen finden Sie unter Gängige Elementstrukturen.
receiveTimestamp String Der Zeitpunkt, zu dem das Ereignis in Google Clouderstellt wurde.
timestamp String Der Zeitpunkt, zu dem das Ereignis in AppNeta erstellt wurde.

Felder für Ereignisdetails

Das Objekt event_detail enthält Details, die für den Ereignistyp spezifisch sind. Je nach event_type enthält es eines der folgenden verschachtelten Objekte:

Für Ereignisse ohne weitere Details wird ein leeres Objekt zurückgegeben.

MTU-Änderungsereignis (mtu_change_event)

Dieses Objekt erfasst Details, wenn die MTU-Größe geändert wird.

Feld Typ Beschreibung
new_mtu int32 Die neu gemessene MTU.
previous_mtu int32 Die vorherige MTU, falls vorhanden (beim Start weggelassen).
mtu_exceeded Hop-Objekt Hop mit Details (z. B. der IP-Adresse) des Knotens, der den Fehler „Paket zu groß“ meldet. Weitere Informationen finden Sie unter Hop.

Ereignis zur Änderung der Dienstqualität (qos_change_event)

Dieses Objekt meldet die QoS-Neuzuordnung auf allen erkannten Pfaden.

Feld Typ Beschreibung
configured_qos int32 Die in den Jobeinstellungen konfigurierte Dienstqualität.
remapped_qos int32 Geänderte Dienstqualität (QoS) im Pfad erkannt.
ip_address String Die IP-Adresse des Hops, bei dem die QoS-Änderung erkannt wurde, falls bekannt.

Ereignis „Weiterleitungsverlust behoben“ (forwarding_loss_clear_event)

Dieses Objekt meldet, dass ein anhaltender Paketverlust, der bei einem bestimmten Netzwerk-Hop (Weiterleitungsverlust) begonnen hat, behoben wurde und die normale Weiterleitung wieder aufgenommen wurde. Dieses Ereignis erfasst, wann die normale Weiterleitung fortgesetzt wird, und den ersten vermuteten Zeitstempel. Der Beginn des Weiterleitungsverlusts wird mithilfe von AppNeta-Alarmen überwacht.

Feld Typ Beschreibung
protocol String Das Monitoring-Protokoll (z. B. TCP, UDP und ICMP).
first_hop Hop-Objekt Der erste Hop, bei dem der Weiterleitungsverlust begonnen hat. Weitere Informationen finden Sie unter Hop.
initial_loss_suspected_time timestamp Der Zeitpunkt, zu dem der Weiterleitungsverlust erstmals vermutet wurde.

Ereignis „Routenänderung“ (route_change_event)

Das Objekt erfasst Unterschiede in der Hop-Anzahl oder der Sequenz bekannter IP-Adressen zwischen aufeinanderfolgenden Traceroutes.

Feld Typ Beschreibung
previous_route_change_time timestamp Der Zeitstempel der Traceroute, die die vorherige Route zuerst erkannt hat.
protocol String Das für die Traceroute verwendete Protokoll (z. B. TCP, UDP und ICMP).
hop_count int32 Die Gesamtzahl der Hops auf der Route.
target_ip String Die Ziel-IP-Adresse des Traceroute.
route_changes Objekt-Array Ein Array aller erkannten Änderungen. Jedes Objekt enthält einen route_change_type-String und ein details-Objekt. Weitere Informationen finden Sie unter Details zu Routenänderungen.

Details zur Routenänderung

Das details-Objekt im route_changes-Array hängt vom route_change_type ab:

  • incomplete_route oder complete_route
    • terminal_hop (Hop-Objekt): Der letzte erfolgreich erreichte Hop (oder der letzte Hop, wenn abgeschlossen).
    • terminal_network (Netzwerkobjekt): Die Netzwerkinformationen für den Terminal-Hop.
  • route_loop
    • first_hop (Hop-Objekt): Der erste Hop in der erkannten Routenschleife.
    • last_hop (Hop-Objekt): Der letzte Hop in der erkannten Routenschleife.
    • loop_span (int32): Die Anzahl der Hops in der Schleife.
  • target_ip_change
    • previous_target_ip (String): Die Ziel-IP-Adresse, die im vorherigen Traceroute beobachtet wurde.
    • new_target_ip (String): Die aktuelle Ziel-IP-Adresse.
  • sequence_change
    • last_common_hop (Hop-Objekt): Der letzte gemeinsame Hop zwischen dem vorherigen und dem aktuellen Traceroute.
    • previous_next_hop (Hop-Objekt): Das vorherige Next-Hop-Gerät in der Sequenz.
    • new_next_hop (Hop-Objekt): Das neue Next-Hop-Gerät in der Sequenz.
    • previous_hop_count (int32): Gesamtzahl der Hops im vorherigen Traceroute.
    • hop_count (int32): Gesamtzahl der Hops im aktuellen Traceroute.
  • network_change
    • previous_asns (Array von int32): Sequenz des ASN-Netzwerks für den Pfad.
    • new_asns (Array von int32): Die neue Sequenz des ASN-Netzwerks für den Pfad.
  • isp_change
    • previous_isp (Netzwerkobjekt): Der ISP, der im vorherigen Traceroute beobachtet wurde.
    • new_isp (Netzwerkobjekt): Der aktuelle Internetanbieter.

Allgemeine Unterobjekte

Hop- und Netzwerkobjekte werden für mehrere Felder zurückgegeben.

Hop

Hop-Objekte beschreiben einen bestimmten Netzwerk-Hop.

Feld Typ Beschreibung
hop_number int32 Die Hop-Nummer im Traceroute.
ip_address String Die IP-Adresse des Hops.
hostname String Der Hostname, der für die IP-Adresse des Hops aufgelöst wurde.

Netzwerk

Ein Netzwerkobjekt beschreibt das Netzwerk, in dem eine Aktion aufgetreten ist.

Feld Typ Beschreibung
asn int32 Die autonome Systemnummer (Autonomous System Number, ASN) des Netzwerks.
display_name String Der Name des Netzwerks (z. B. Name des Internetanbieters oder der Organisation).

Gängige Elementstrukturen

Das Feld „item“ im jsonPayload von Alarm- und Ereignisprotokollen enthält Details zur zugehörigen Entität. Die Struktur hängt vom Artikeltyp ab.

NetworkPathItem

Feld Typ Beschreibung
destination String Die Ziel-IP-Adresse oder der Ziel-Hostname.
destination_monitoring_point MonitoringPointItem Details zum Ziel-MonitoringPointItem (nur für MonitoringPoint-zu-MonitoringPoint-Pfade).
display_name String Der benutzerdefinierte Anzeigename des Netzwerkpfads.
monitoring_policy_display_name String Der Anzeigename der Monitoringrichtlinie.
monitoring_policy_id String Die ID der Monitoringrichtlinie.
network_protocol String Das verwendete Netzwerkprotokoll, z. B. TCP, UDP oder ICMP.
provider_tags Objekt-Array In AppNeta für den Pfad definierte Tags.
source_monitoring_point MonitoringPointItem Details zum MonitoringPointItem der Quelle.

WebPathItem

Feld Typ Beschreibung
destination String Die Ziel-URL.
display_name String Der benutzerdefinierte Anzeigename des Webpfads.
monitoring_policy_display_name String Der Anzeigename der Monitoringrichtlinie.
monitoring_policy_id String Die ID der Monitoringrichtlinie.
provider_tags Array Im Anbieter für den Pfad definierte Tags.
source_monitoring_point Objekt Details zum MonitoringPoint der Quelle.

MonitoringPointItem

Feld Typ Beschreibung
display_name String Der benutzerdefinierte Anzeigename des Monitoring Point.
host Objekt Details zum Host des Monitoring Points.
id String Die eindeutige Kennung des Monitoring-Punkts.
provider_tags Array Im Anbieter für den Monitoring Point definierte Tags.

MonitoringPointHost

Feld Typ Beschreibung
cloud_instance_id String Die Instanz-ID des Cloud-Anbieters.
cloud_project_id String Die Google Cloud -Projekt-ID.
cloud_provider String Cloud-Anbieter wie GCP, AWS oder AZURE.
cloud_region String Die Cloud-Region des Endpunkts, z. B. us-central1.
cloud_virtual_network_ids String-Array Für Nutzer sichtbare IDs des virtuellen Cloud-Netzwerks.
cloud_zone String Die Cloud-Zone des Endpunkts, z. B. us-central1-a.
labels Karte Benutzerdefinierte Labels, die auf der VM-Instanz konfiguriert sind.
os String Das Betriebssystem des Hosts des Monitoring Points.