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.
Öffnen Sie die Google Cloud Console und rufen Sie Network Intelligence > Cloud Network Insights > Benachrichtigungsrichtlinien auf.
Klicken Sie auf Alarmregeln erstellen, um die Seite Alarmregel bearbeiten in AppNeta zu öffnen.
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.
Rufen Sie in der Google Cloud Console die Seite Log-Explorer auf.
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/MonitoringPointnetworkmanagement.googleapis.com/NetworkPathnetworkmanagement.googleapis.com/WebPath
labels: Schlüssel/Wert-Paare, die die spezifische Ressourceninstanz identifizieren, z. B.resource_container(Projekt-ID),location,network_monitoring_provider_idundpath_idodermonitoring_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:
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 ChangeoderMonitoring 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_routeodercomplete_routeterminal_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_loopfirst_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_changeprevious_target_ip(String): Die Ziel-IP-Adresse, die im vorherigen Traceroute beobachtet wurde.new_target_ip(String): Die aktuelle Ziel-IP-Adresse.
sequence_changelast_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_changeprevious_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_changeprevious_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. |