Instanzen organisieren und Kosten mithilfe von Labels ansehen

Auf dieser Seite wird beschrieben, wie Sie Google Cloud Labels verwenden, um Ihre Spanner-Instanzen zu organisieren und eine detaillierte Kostenaufschlüsselung aufzurufen.

Ein Google Cloud Label ist ein Schlüssel/Wert-Paar, das Sie einzelnen Google Cloud Ressourcen wie Spanner-Instanzen zuweisen können.

Labels helfen Ihnen dabei, diese Ressourcen zu organisieren und Ihre Kosten mit der erforderlichen Detailgenauigkeit zu sehen. Informationen zu Labels werden an das Abrechnungssystem weitergeleitet, sodass Sie die in Rechnung gestellten Gebühren nach Label aufschlüsseln können. Weitere Informationen zu Labels finden Sie unter Labels – Übersicht.

Häufige Anwendungsfälle für Labels

Labels kommen u. a. in folgenden Situationen zum Einsatz:

  • Labels für Teams oder Kostenstellen:Unterscheiden Sie zwischen Ressourcen, die verschiedenen Teams gehören (z. B. team:research und team:analytics), für die Kostenabrechnung oder Budgetplanung.
  • Labels für Umgebungen:Geben Sie Entwicklungs-, Test- oder Produktionsumgebungen an (z. B. env:dev, env:test und env:prod).
  • Labels für Komponenten:Kategorisieren Sie Ressourcen nach Anwendungskomponente oder Arbeitslasttyp (z. B. component:frontend und component:backend).
  • Detaillierte Verfolgung auf Instanzebene:Kennzeichnen Sie Spanner-Instanzen mit ihrer eigenen ID oder einer bestimmten Kennung (z. B. instance_id:my-instance-1), um die Kosten pro Instanz in Abrechnungsberichten oder BigQuery-Abfragen direkt aufzuschlüsseln.

Anforderungen und Einschränkungen

Für Labels, die auf Spanner-Instanzen angewendet werden, gelten die folgenden Anforderungen:

  • Jede Instanz kann bis zu 64 Labels haben.
  • Schlüssel und Werte dürfen maximal 63 Zeichen lang sein.
  • Schlüssel und Werte dürfen nur Kleinbuchstaben, Ziffern, Unterstriche (_) und Bindestriche (-) enthalten.
  • Schlüssel müssen mit einem Kleinbuchstaben oder einem internationalen Zeichen beginnen. Schlüssel dürfen nicht leer sein.
  • Der Schlüsselabschnitt eines Labels darf in einer einzelnen Instanz nur einmal vorkommen.

Labels für Spanner-Instanzen hinzufügen und verwalten

Sie können Labels hinzufügen, wenn Sie eine Spanner-Instanz erstellen, oder die Labels für eine vorhandene Instanz aktualisieren.

Erforderliche Berechtigungen

Zum Aufrufen und Verwalten von Labels für Spanner-Instanzen benötigen Sie die folgenden IAM-Berechtigungen:

  • spanner.instances.get
  • spanner.instances.update

Diese Berechtigungen sind in der Rolle roles/spanner.admin enthalten.

Labels hinzufügen, aktualisieren oder entfernen

Console

  1. Rufen Sie in der Google Cloud Console die Seite Spanner-Instanzen auf.

    Spanner-Instanzen aufrufen

  2. Klicken Sie das Kästchen neben der Instanz an, die Sie mit einem Label versehen möchten. Das Infofeld wird angezeigt.

  3. Wählen Sie im Infofeld die Option Labels aus.

  4. Fügen Sie Labels für die Instanz hinzu, aktualisieren oder löschen Sie sie und klicken Sie dann auf Speichern.

gcloud

Führen Sie den Befehl gcloud spanner instances create mit dem Flag --labels aus, um eine Spanner-Instanz mit Labels zu erstellen:

gcloud spanner instances create INSTANCE_ID \
    --config=INSTANCE_CONFIG \
    --description=INSTANCE_NAME \
    --nodes=NODE_COUNT \
    --labels=KEY=VALUE,KEY=VALUE

Führen Sie den Befehl gcloud spanner instances update mit dem Flag --update-labels aus, um Labels für eine vorhandene Instanz hinzuzufügen oder zu aktualisieren:

gcloud spanner instances update INSTANCE_ID \
    --update-labels=KEY=VALUE,KEY=VALUE

Verwenden Sie das Flag --remove-labels, um bestimmte Labels aus einer vorhandenen Instanz zu entfernen:

gcloud spanner instances update INSTANCE_ID \
    --remove-labels=KEY1,KEY2

Verwenden Sie das Flag --clear-labels, um alle Labels aus einer vorhandenen Instanz zu entfernen:

gcloud spanner instances update INSTANCE_ID --clear-labels

Spanner-Kosten nach Labels in Cloud Billing analysieren

Nachdem Sie Labels auf Ihre Spanner-Instanzen angewendet haben, können Sie damit Ihre Kosten analysieren. Die Labels werden an Ihre Kostendaten weitergeleitet, sodass Sie Gebühren filtern und gruppieren können.

Nach Labels gruppierte Kosten in Abrechnungsberichten ansehen

Sie können Ihre Spanner-Kosten nach Labelschlüsseln gruppiert direkt in der Google Cloud Console ansehen und analysieren:

  1. Rufen Sie in der Google Cloud Console den Bereich Abrechnung auf.
  2. Wählen Sie Ihr Abrechnungskonto aus und klicken Sie im Navigationsbereich auf Berichte.
  3. Im Bereich Filter :
    1. Wählen Sie unter Dienste die Option Spanner aus, um die Kosten für Ihre Spanner-Datenbank zu isolieren.
    2. Wählen Sie unter Gruppieren nach die Option Labelschlüssel aus und wählen Sie den Labelschlüssel aus, den Sie analysieren möchten (z. B. environment oder instance_id).
  4. Das Diagramm und die Kostentabelle werden aktualisiert und zeigen eine detaillierte Aufschlüsselung der Kosten, gruppiert nach den einzelnen Labelwerten (z. B. environment:prod und environment:dev oder instance_id:my-instance-1 und instance_id:my-instance-2).