In diesem Dokument erhalten Sie einen kurzen Überblick über Labels und ihre Funktionen.
Was sind Labels?
Ein Label ist ein Schlüssel/Wert-Paar, das Sie Google Cloud-Ressourcen zuweisen können. Clusterlabels helfen Ihnen dabei, diese Ressourcen zu organisieren und Ihre Kosten in großem Umfang mit der erforderlichen Detailgenauigkeit zu verwalten. Sie können jeder Ressource ein Label zuweisen und dann die Ressourcen basierend auf ihren Labels filtern. Informationen zu Labels werden an das Abrechnungssystem weitergeleitet, sodass Sie die abgerechneten Gebühren nach Label aufschlüsseln können. Dank integrierter Abrechnungsberichte können Sie Kosten nach Ressourcenlabels filtern und gruppieren. Sie können Labels auch verwenden, um Abrechnungsdatenexporte abzufragen.
Anforderungen an Labels
Die Labels, die auf eine Ressource angewendet werden, müssen die folgenden Anforderungen erfüllen:
- Jede Ressource kann bis zu 64 Labels haben.
- Jedes Label muss ein Schlüssel/Wert-Paar sein.
- Schlüssel haben eine Mindestlänge von 1 Zeichen und eine maximale Länge von 63 Zeichen und dürfen nicht leer sein. Werte dürfen leer sein und haben eine maximale Länge von 63 Zeichen.
- Schlüssel und Werte dürfen nur Kleinbuchstaben, Ziffern, Unterstriche und Bindestriche enthalten. Alle Zeichen müssen UTF-8-codiert sein. Internationale Zeichen sind zulässig. Schlüssel müssen mit einem Kleinbuchstaben oder einem internationalen Zeichen beginnen.
- Der Schlüsselabschnitt eines Labels darf in einer einzelnen Ressource nur einmal vorkommen. Sie können jedoch denselben Schlüssel für mehrere Ressourcen verwenden.
Die Limits gelten für den Schlüssel und den Wert für jedes Label und für die einzelnen Google Cloud-Ressourcen, die Labels haben. Es gibt keine Beschränkung, wie viele Labels Sie auf alle Ressourcen in einem Projekt anwenden können.
Einsatzmöglichkeiten von Labels
Labels kommen u. a. in folgenden Situationen zum Einsatz:
Labels für Teams oder Kostenstellen: Fügen Sie Labels basierend auf einem Team oder einer Kostenstelle hinzu, um zwischen den Ressourcen von verschiedenen Teams zu unterscheiden (z. B.
team:research
undteam:analytics
). Diese Art von Label können Sie für die Kostenabrechnung oder Budgetplanung nutzen.Labels für Komponenten: z. B.
component:redis
,component:frontend
,component:ingest
undcomponent:dashboard
.Labels für Umgebungen oder Phasen: z. B.
environment:production
undenvironment:test
.Labels für Status: z. B.
state:active
,state:readytodelete
undstate:archive
.Labels für Eigentumsrechte: Wird verwendet, um die Teams zu identifizieren, die für den Betrieb verantwortlich sind, z. B.
team:shopping-cart
.
- Netzwerklabels: Labels können an virtuelle Maschinen angehängt werden. Bereits definierte Netzwerk-Tags werden als Labels ohne Wert angezeigt.
Es wird empfohlen, nicht zu viele eindeutige Labels zu erstellen, etwa für Zeitstempel oder einzelne Werte für einzelne API-Aufruf. Das Problem bei diesem Ansatz besteht darin, dass es schwierig ist, Ressourcen effektiv zu filtern und Berichte über sie zu erstellen, wenn sich die Werte häufig ändern oder wenn Schlüssel verwendet werden, die den Katalog überlasten.
Labels und Tags
Labels können als abfragbare Annotationen für Ressourcen verwendet werden, aber nicht zum Festlegen von Bedingungen für Richtlinien. Mit Tags können Sie Richtlinien auf Basis der Bedingung genehmigen oder ablehnen, ob eine Ressource ein bestimmtes Tag hat. Dazu müssen Sie eine detaillierte Richtlinienkontrolle ermöglichen. Weitere Informationen finden Sie in der Tag-Übersicht.
Berechtigungen
Die folgenden Berechtigungen sind erforderlich, wenn Sie Labels für Projekte hinzufügen, ändern und aufrufen möchten:
- Sie können ein Label hinzufügen oder ändern. Rufen Sie dazu die Methode
projects.patch()
auf. Hierfür ist die Berechtigungresourcemanager.projects.update
erforderlich. - Sie können das Label eines Projekts abrufen. Rufen Sie dazu die Methode
projects.get()
auf. Hierfür ist die Berechtigungresourcemanager.projects.get
erforderlich.
Kosten mithilfe von Labels analysieren
Sie können einer Ressource ein Label zuweisen und dann die Ressourcen nach den Labels filtern. Informationen zu Labels werden an das Abrechnungssystem weitergeleitet, sodass Sie die in Rechnung gestellten Gebühren nach Label aufschlüsseln können.
So können Sie mithilfe von Labels die Kosten besser nachvollziehen:
- Sie können Ihren VMs oder Cloud Storage-Buckets Labels wie
costcenter=cost_center_name
,service=service_name
undenvironment=environment_name
hinzufügen. So können Sie nachvollziehen, wo Ihre Ressourcen bereitgestellt werden, zu welchem Zweck und welcher Kostenstelle sie in Rechnung gestellt werden sollten. - Sie können den Export von Abrechnungsdaten nach BigQuery aktivieren. Labels werden zusammen mit den entsprechenden Google Cloud-Ressourcen und deren Nutzung nach BigQuery exportiert. So können Sie Aspekte wie die Kosten für die Ausführung des Einkaufswagendienstes in der Anwendung oder die Kosten für Entwickler-Testmaschinen im Blick behalten.
- Sie können BigQuery in Kombination mit Labels verwenden, um die Kosten aller Testsystemressourcen im Vergleich zu Produktionsressourcen oder die Kosten eines bestimmten Dienstes zu ermitteln.
Beispiel
In diesem Beispiel werden die Kosten für playlist
-Dienste für ein Projekt ermittelt, indem die Nutzung und Labels nach BigQuery exportiert werden.
Aktivieren Sie dazu zuerst den Abrechnungsexport nach BigQuery. labels-demo-prj
ist die Quelle der Ressourcennutzung und labels_demo_bqexport
ist das Ziel-Dataset, in dem die Nutzungsdaten gespeichert werden. Nachdem Sie Ihre Nutzung und Labels nach BigQuery exportiert haben, können Sie die Kosten für den playlist
-Dienst ermitteln.
Hier finden Sie Details zur Compute Engine-Nutzung und den zugehörigen Kosten in BigQuery.