Veraltete Metadatenlabels von Ressourcen

Überwachte Ressourcen in Cloud Monitoring enthalten eine Reihe von Labels, mit denen eine bestimmte Instanz des Typs der überwachten Ressource identifiziert werden kann. Diese Labels sind für jeden Typ überwachter Ressourcen in der Liste der überwachten Ressourcen dokumentiert.

Darüber hinaus können mit Monitoring zusätzliche Labels erstellt werden, um Metadaten zu einer überwachten Ressource zu erfassen. Diese Systemmetadatenlabels stehen Nutzern als schreibgeschützte Werte zur Verfügung. Nutzer können auch eigene Labels für Ressourcenmetadaten erstellen. Weitere Informationen dazu finden Sie unter Ressourcen-Metadatenlabels.

Eine Gruppe von Metadatenlabels für überwachte Ressourcen wurde verworfen. Die Labels in der Gruppe sind entweder redundant und können durch vorhandene gleichwertige Labels ersetzt werden oder sie stellen veraltete Konzepte dar, die nicht mehr von den Benachrichtigungsrichtlinien, Diagrammen, Kurzübersichten oder Ressourcengruppen in Cloud Monitoring unterstützt werden.

Auswirkungen der Verwerfung

Alle Benachrichtigungsrichtlinien, Diagramme, Kurzübersichten und Ressourcengruppen, die eine überwachte Ressource angeben und Metadatenlabels verwenden, für die Ersatzlabels ermittelt werden könnten, wurden bis zum 31. Juli 2020 automatisch migriert. Alle anderen Verwendungen von verworfenen Labels müssen manuell migriert werden. Auf dieser Seite finden Sie Informationen zur Migration dieser Labels.

Hinweis:

• Wenn Sie einen Filter haben, der keine überwachten Ressourcen definiert, aber Metadatenlabels verwendet, kann nicht festgestellt werden, ob das Metadatenlabel verworfen wurde. Metadatenlabels sind in überwachten Ressourcen nicht eindeutig und verworfene Labels sind bestimmten überwachten Ressourcen zugeordnet. Sie müssen solche Filter manuell prüfen.
• Metadatenlabels in Filtern einer sekundären Aggregation wurden nicht automatisch migriert.
• Metadatenlabels in Abfragen, die in Monitoring Query Language (MQL) geschrieben wurden, wurden nicht automatisch migriert.

Benachrichtigungsrichtlinien, Diagramme, Kurzübersichten und Ressourcengruppen, die Metadatenlabels verwenden, die bis zum 31. Juli 2020 nicht automatisch oder manuell migriert wurden, werden nicht mehr unterstützt und funktionieren möglicherweise nicht mehr.

Erforderliche Aktion

Wenn Sie Benachrichtigungsrichtlinien, Diagramme, Kurzübersichten oder Ressourcengruppen reparieren möchten, die aufgrund verworfener Metadatenlabels nicht mehr funktionieren, müssen Sie verschiedene Maßnahmen ergreifen. Sie können die Benachrichtigungsrichtlinien, Diagramme, Kurzübersichten oder Gruppen entfernen. Sie können auch Filter ändern, die diese verworfenen Labels verwenden, um Labels mit ähnlichem Verhalten zu nutzen.

Genauso kann, wenn Sie Filter mit Metadatenlabels haben, aber keine überwachten Ressourcen definieren, nicht automatisch ermittelt werden, ob diese Labels verworfen wurden. Sie müssen sie deshalb manuell prüfen und ersetzen.

Diese Seite bietet ein Skript, mit dem Sie die Verwendung verworfener Metadatenlabels ermitteln können.

Verworfene Metadatenlabels

In der folgenden Tabelle sind die verworfenen Ressourcenmetadatenlabels und gegebenenfalls deren Ersetzung aufgeführt.

Hinweis: In Filtern wird das Labelpräfix resource.metadata verwendet, wenn in der Tabelle das Präfix metadata.system_labels steht. Das Label, das in der Tabelle als metadata.system_labels.name zu sehen ist, wird bei Filtern als resource.metadata.name bezeichnet.

Typ der überwachten Ressource	Verworfenes Label	Ersatzlabel
Alle Google Cloud-Typen	metadata.system_labels.cloud_account^*	resource.labels.project_id
cloud_tasks_queue	metadata.system_labels.name metadata.system_labels.state	resource.labels.queue_id –
dataflow_job	metadata.system_labels.name metadata.system_labels.state	resource.labels.job_name –
gae_app	metadata.system_labels.gaeapp metadata.system_labels.gaemodule metadata.system_labels.gaeversion	–^† Prüfen Sie die Verwendung von resource.labels.project_id –^† Prüfen Sie die Verwendung von resource.labels.module_id –^† Prüfen Sie die Verwendung von resource.labels.version_id
gce_disk	metadata.user_labels.name^‡	metadata.system_labels.name
gce_instance	metadata.user_labels.name^‡	metadata.system_labels.name
l7_lb_rule	metadata.system_labels.state	–
pubsub_topic	metadata.system_labels.name^#	metadata.system_labels.name
pubsub_subscription	metadata.system_labels.name^#	metadata.system_labels.name
vpn_gateway	metadata.system_labels.region	resource.labels.region

^* Bei der Filtersyntax von Cloud Monitoring ist die Verwendung des Labels resources.labels.project_id nicht flexibler, da das Label metadata.system_labels.cloud_account verwendet werden könnte. Folgendes ist beispielsweise nicht möglich:

• Verwenden Sie die Operation OR, um einen Ausdruck mit dem Label project_id und einen Ausdruck mit Metadatenlabels zu kombinieren.
• Verwenden Sie die Operation != mit dem Label project_id.
• Verwenden Sie die Funktion starts_with oder has_substring mit dem Label project_id.

^† Für gae_app-Ressourcen: Die angegebenen Ressourcenlabels ähneln den verworfenen Metadatenlabels. Sie sind also eventuell eine gute Alternative. Da sie jedoch nur ähnlich sind, werden sie nicht automatisch migriert.

^‡ Für gce_disk- und gce_instance-Ressourcen: Wenn Sie metadata.user_labels.name nicht anders festlegen, wird automatisch der Wert metadata.system_labels.name eingegeben. Die automatische Eingabe von Werten endet ebenfalls am 31. Juli 2020. Benachrichtigungsrichtlinien, Diagramme, Kurzübersichten und Ressourcengruppen, die nach dem automatisch ausgefüllten Wert metadata.user_labels.name filtern, wurden stattdessen für die Verwendung von metadata.system_labels.name migriert.

^# Für pubsub_topic- und pubsub_subscription- Ressourcen: Wir haben einen seit Langem bestehenden Fehler behoben, durch den metadata.system_labels.name automatisch in Kleinbuchstaben umgewandelt wurde (z. B. "My-Subscription" zu "my-subscription"). Dies führte zu unerwartetem Verhalten, wenn Nutzer mehrere Ressourcen mit identischen Kleinbuchstaben hatten. Dieses Verhalten endete ebenfalls am 31. Juli 2020. Nach diesem Datum spiegelt das Metadatensystemlabel name den tatsächlichen Namen des Themas oder des Abos wieder (z. B. "My-Subscription").

Was muss ich tun?

Es gibt zwei allgemeine Schritte:

1. Prüfen Sie, ob Sie Metadatenlabels verwenden, die von dieser Einstellung betroffen sind. Informationen zum Ausführen des bereitgestellten Detektorskripts finden Sie unter Verworfene Metadatenlabels suchen.

2. Wenn Sie betroffene Metadatenlabels verwenden, müssen Sie diese aktualisieren oder entfernen. Weitere Informationen finden Sie unter Filter aktualisieren.

Verworfene Metadatenlabels suchen

Mit diesem Python-Skript können Sie Verweise auf verworfene Metadatenlabels ermitteln: metadata_label_detection.py.

Hinweis: Das Skript kann Metadatenlabels in Filtern sekundärer Aggregationen nicht erkennen.

Zusammenfassung der Syntax: python3 metadata_label_detection.py PROJECT_ID_OR_NUMBER

PROJECT_ID_OR_NUMBER kann entweder eine Projekt-ID (z. B. my-project) oder eine Projektnummer (z. B. 123456789) sein. Geben Sie nicht das Präfix projects/ an.

Die folgenden Schritte zeigen eine Möglichkeit zur Anwendung des Skripts:

1. Öffnen Sie die Google Cloud Console.

   Zur Google Cloud Console

2. Klicken Sie oben auf der Seite der Google Cloud Console für Ihr Projekt auf Cloud Shell aktivieren.

3. Klicken Sie in der Cloud Shell-Symbolleiste auf Editor öffnen. Wenn der Arbeitsbereich für Ihr Basisverzeichnis noch nicht aktiviert ist, öffnen Sie ihn durch Auswahl von Datei und Arbeitsbereich öffnen. Wählen Sie den Arbeitsbereich mit Ihrem Nutzernamen aus.

4. Erstellen Sie eine neue Datei namens metadata_label_detection.py und wählen Sie dafür Datei und Neue Datei aus. Fügen Sie den Text von metadata_label_detection.py in den Editor ein. Wählen Sie Datei und Speichern aus, um die Datei zu speichern.

5. Kehren Sie zum Terminal zurück und klicken Sie dazu in der Cloud Shell-Symbolleiste auf Terminal öffnen.

6. Installieren Sie an der Eingabeaufforderung der Befehlszeile in Cloud Shell die Skriptabhängigkeiten mit folgendem Befehl:

   sudo pip3 install google-cloud-monitoring=="1.*" google-cloud-monitoring-dashboards
   

7. Führen Sie nach der Installation der Abhängigkeiten das Detektorskript aus:

   python3 metadata_label_detection.py $GOOGLE_CLOUD_PROJECT
   

Das Skript generiert dann einen Bericht wie im folgenden Auszug:

Alert "Test alert" (projects/PROJECT_ID/alertPolicies/8401129027900817186) is affected.
URL: https://console.cloud.google.com/monitoring/alerting/policies/8401129027900817186?project=PROJECT_ID
        metadata.system_labels.cloud_account is deprecated for non-AWS resource
types. Please manually remove the reference.

Group "Test group" (projects/PROJECT_ID/groups/4518177785663978371) might be affected,
depending on the type of resources it is used for.
URL: https://console.cloud.google.com/monitoring/groups/4518177785663978371?project=PROJECT_ID
        metadata.system_labels.name is deprecated for dataflow_job. Please
manually remove the reference if this group is used for dataflow_job resources.
        metadata.system_labels.name is deprecated for cloud_tasks_queue. Please
manually remove the reference if this group is used for cloud_tasks_queue resources.

Xy_chart "Test chart" in dashboard "Demo dashboard" (projects/PROJECT_ID/dashboards/2826428163455705326) is affected.
URL: https://console.cloud.google.com/monitoring/dashboards/custom/2826428163455705326?project=PROJECT_ID
        metadata.user_labels.name is deprecated for gce_instance. Please
manually remove the reference.

Hinweis: In Filtern wird das Labelpräfix resource.metadata verwendet, wenn bei Skripts das Präfix metadata.system_labels ausgegeben wird. Das Label, das in der Ausgabe als metadata.system_labels.name zu sehen ist, wird bei Filtern als resource.metadata.name bezeichnet.

Filter aktualisieren

So aktualisieren Sie Benachrichtigungsrichtlinien, Diagramme, Kurzübersichten und Ressourcengruppen:

1. Melden Sie sich in der Google Cloud Console an.

2. Führen Sie das Detektorskript wie unter Verworfene Labels suchen beschrieben aus.

3. Prüfen Sie für jede Benachrichtigungsrichtlinie, jedes Diagramm und jede Ressourcengruppe, ob der abgerufene Wert von einem der verworfenen Labels stammt, die vom Skript ermittelt wurden.

   Bei allen Diagrammen müssen Sie jedes Diagramm in jedem von Ihnen definierten benutzerdefinierten Dashboard prüfen.

   Filter verwenden das Präfix resource.metadata anstelle von metadata.system_labels.

   Hinweis: Wenn Sie mit der API Dashboards mit Kurzübersichten erstellt haben, müssen Sie diese mit der API prüfen. Kurzübersichten können nicht über die Google Cloud Console bearbeitet werden.

   Führen Sie für jedes verworfene Label einen der folgenden Schritte aus:

   • Wenn das Label nicht ersetzt werden kann, beenden Sie die Verwendung des Labels oder löschen Sie die Benachrichtigungsrichtlinie, das Diagramm oder die Ressourcengruppe.

   • Wenn für das Label ein Ersatz vorhanden ist, ersetzen Sie das verworfene Label damit.

   Wenn Sie nichts tun, funktionieren die betroffene Benachrichtigungsrichtlinie, das Diagramm oder die Ressourcengruppe nicht.

   Weitere Informationen zum Aktualisieren mithilfe der Google Cloud Console finden Sie in den unter Bearbeiten aufgelisteten Ressourcen.

   In einigen Fällen müssen Sie möglicherweise die Cloud Monitoring API anstelle der Google Cloud Console verwenden. Mit der API lassen sich einige Abfragen ausführen, die ansonsten nicht zusammengestellt werden können.

4. Führen Sie das Detektorskript noch einmal aus, um zu prüfen, ob noch verworfene Labels vorhanden sind.

Weitere Informationen

Informationen zu Ressourcenmetadatenlabels, Filtern oder bestimmten Typen von überwachten Ressourcen finden Sie unter:

• Labels: Ressourcenmetadatenlabels
• Filter: Monitoring-Filter
• Bestimmte Typen von überwachten Ressourcen: Liste der überwachten Ressourcen

Bearbeiten

Informationen zum Aktualisieren von Benachrichtigungsrichtlinien, Diagrammen, Dashboards und Ressourcengruppen finden Sie unter:

• Benachrichtigungsrichtlinien: Richtlinien verwalten
• Dashboards und Diagramme mit der Google Cloud Console verwenden: Dashboards verwalten
• Dashboards mit der Monitoring API verwenden: Dashboards aktualisieren
• Ressourcengruppen: Gruppe bearbeiten