Logging einrichten

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

Aufgaben für Logging und Benachrichtigungen werden zwischen Google Cloud und AppNeta aufgeteilt. Bei der Cloud Network Insights-Protokollierung wird erfasst, wann die von Monitoring Points erfassten Messwerte gegen Grenzwerte verstoßen, die Sie mit Alarmregeln in AppNeta konfigurieren.

Erstellen Sie Alarme und Alarmregeln in AppNeta, um Alarmprotokolle zu generieren. Alarm- und Ereignislogs 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.

Wecker in AppNeta

Alarme und Alarmregeln werden in AppNeta erstellt. Alarme informieren Sie, wenn ein Problem in Ihrem Netzwerk vorliegt. Wenn ein von Ihnen beobachteter Messwert, z. B. die Latenz, innerhalb eines bestimmten Intervalls einen festgelegten Schwellenwert überschreitet, liegt ein Verstoß gegen die Alarmregel vor. Sie können festlegen, dass ein Alarm nach einem einzelnen Verstoß oder nach mehreren Verstößen innerhalb eines bestimmten Zeitraums 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 Log an Google Cloud gesendet. Sobald das Log in Cloud Logging eingeht, können Sie eine Benachrichtigung senden und Ihr Team benachrichtigen.

Weitere Informationen zu Benachrichtigungen finden Sie in der AppNeta-Dokumentation unter Alarms Overview (Übersicht über Benachrichtigungen) oder Alarms – Best Practices (Benachrichtigungen – Best Practices).

Alarmregeln in AppNeta erstellen

Erstellen Sie Alarmregeln, in denen Leistungs-Schwellenwerte definiert werden.

  1. Öffnen Sie die Google Cloud -Konsole 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, in denen Messwerte, Grenzwerte, Strategien für Verstöße und Schweregrad angegeben werden. Sie können Standardregeln verwenden oder anpassen.

Wenn ein Alarm ausgelöst wird, wird das Alarmlog an Cloud Logging gesendet. Nachdem das Log an Google Cloudgesendet wurde, können Sie zu Cloud Network Insights navigieren und 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. Erstellen Sie Abfragen, um Benachrichtigungen zu relevanten Informationen zu erhalten.

In Cloud Network Insights-Logs wird für logName einer der folgenden Werte verwendet:

  • 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 Kosten für 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 zwar im Feld jsonPayload enthalten, aber mehrere andere Standardfelder von LogEntry sind für das Abfragen und Analysieren der Logs von entscheidender Bedeutung.

Weckerprotokolle

  • Log Name (Protokollname): networkmanagement.googleapis.com/insights_alarm
  • Ausgelöst: Wird generiert, wenn die Bedingungen einer Alarmregel erfüllt sind.
  • Ressourcenlabels: Beschreibt die mit dem Log verknüpfte überwachte Ressource. Dazu gehören die folgenden:
    • type: Der Ressourcentyp. Er kann einer der folgenden sein:
      • networkmanagement.googleapis.com/NetworkMonitoringProvider
      • networkmanagement.googleapis.com/MonitoringPoint
      • networkmanagement.googleapis.com/NetworkPath
    • labels: Schlüssel/Wert-Paare zur Identifizierung der jeweiligen Ressourceninstanz, z. B. resource_container (Projekt-ID), location, network_monitoring_provider_id und path_id oder monitoring_point_id.
  • Wichtige JSON-Felder: Alarmlogs 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

Felder im Alarmprotokoll

Die jsonPayload eines Alarmprotokolls enthält die folgenden Felder.

Feld Typ Beschreibung
alarm_id String Die eindeutige Kennung für den Alarm in AppNeta.
alarm_type enum Der Typ des Alarms. Der Typ QUALITY_OF_SERVICE wird unterstützt.
state enum Der Status des Alarms. Kann RAISED, UPDATED (die Alarmdetails wurden in AppNeta aktualisiert, aber noch nicht behoben) oder CLEARED sein.
alarm_severity enum Der Schweregrad des Alarms. Kann CRITICAL, MAJOR, MINOR oder WARNING sein.
rule String Der Name der Alarmregel, die den Alarm ausgelöst hat.
description String Eine für Menschen lesbare Beschreibung des Alarms.
first_violation_time timestamp Der Zeitpunkt, zu dem die Alarmbedingung zum ersten Mal verletzt wurde.
raised_time timestamp Die Uhrzeit, zu der der Alarm ausgelöst wurde.
cleared_time timestamp Die Uhrzeit, zu der der Alarm deaktiviert wurde. Dieses Feld ist leer, wenn das Alarmprotokoll den Status RAISED oder UPDATED hat.
provider_link String Ein Hyperlink zum Alarm in der AppNeta-Benutzeroberfläche.
item Objekt Die mit dem Alarm verknüpfte Entität. Weitere Informationen finden Sie unter Häufige Artikelstrukturen.
timestamp String Der Zeitpunkt, zu dem der Alarm in AppNeta erstellt wurde.
receiveTimestamp String Die Uhrzeit, zu der der Wecker in Google Clouderstellt wurde.

Ereignisprotokolle

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

Felder für Ereignisprotokolle

Das jsonPayload eines Ereignislogs enthält die folgenden Felder.

Feld Typ Beschreibung
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 oder QOS_CHANGE sein.
item Objekt Die mit dem Ereignis verknüpfte Entität. Weitere Informationen finden Sie unter Häufige Artikelstrukturen.
event_detail Objekt Details, die für den Ereignistyp spezifisch sind. Das kann route_change_event, mtu_change_event oder qos_change_event sein. Für Ereignisse ohne weitere Details wird ein leeres Objekt zurückgegeben.
timestamp String Die Uhrzeit, zu der das Ereignis in AppNeta erstellt wurde.
receiveTimestamp String Die Uhrzeit, zu der das Ereignis in Google Clouderstellt wurde.

Gängige Artikelstrukturen

Das Feld „item“ im jsonPayload der Alarm- und Ereignisprotokolle enthält Details zur zugehörigen Einheit. Die Struktur hängt vom Elementtyp ab.

NetworkPathItem

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

WebPathItem

Feld Typ Beschreibung
display_name String Der benutzerdefinierte Anzeigename des Webpfads.
destination String Die Ziel-URL.
monitoring_policy_id String Die ID der Monitoringrichtlinie.
monitoring_policy_display_name String Der Anzeigename der Monitoringrichtlinie.
provider_tags Array Tags, die im Anbieter für den Pfad definiert sind.
source_monitoring_point Objekt Details zum Quell-MonitoringPoint.

MonitoringPointItem

Feld Typ Beschreibung
id String Die eindeutige ID des Monitoring-Punkts.
display_name String Der benutzerdefinierte Anzeigename des Monitoring Point.
host Objekt Details zum Host des Monitoring Point.
provider_tags Array Tags, die im Anbieter für den Monitoring Point definiert sind.

MonitoringPointHost

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