Instanzen organisieren und Kosten mithilfe von Labels ansehen

Auf dieser Seite wird beschrieben, wie Sie mit Google Cloud -Labels Ihre Spanner-Instanzen organisieren und eine detaillierte Kostenaufschlüsselung aufrufen können.

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

Mit Labels können Sie diese Ressourcen organisieren und Ihre Kosten mit der erforderlichen Detailgenauigkeit ansehen. Informationen zu Labels werden an das Abrechnungssystem weitergeleitet, sodass Sie die abgerechneten Gebühren nach Label aufschlüsseln können. Weitere Informationen zu Labels finden Sie unter Labels – Übersicht.

Häufige Anwendungsfälle für Labels

Typische Anwendungsfälle für Labels:

  • Labels für Teams oder Kostenstellen: Unterscheiden Sie zwischen Ressourcen, die verschiedenen Teams gehören (z. B. team:research und team:analytics), um die Kostenabrechnung oder Budgetplanung zu erleichtern.
  • Umgebungslabels: Geben Sie Entwicklungs-, Test- oder Produktionsumgebungen an (z. B. env:dev, env:test und env:prod).
  • Komponentenlabels:Ressourcen nach Anwendungskomponente oder Workload-Typ kategorisieren (z. B. component:frontend und component:backend).
  • Detaillierte Erfassung auf Instanzebene:Sie können Spanner-Instanzen mit einer eigenen ID oder einer bestimmten Kennung (z. B. instance_id:my-instance-1) kennzeichnen, um die Kosten in Abrechnungsberichten oder BigQuery-Abfragen direkt nach Instanz aufzuschlüsseln.

Anforderungen und Einschränkungen

Labels, die auf Spanner-Instanzen angewendet werden, müssen die folgenden Anforderungen erfüllen:

  • 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 einer vorhandenen 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.

    Zu Spanner-Instanzen

  2. Klicken Sie auf das Kästchen neben der Instanz, der Sie ein Label hinzufügen 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

Wenn Sie Labels in einer vorhandenen Instanz hinzufügen oder aktualisieren möchten, führen Sie den Befehl gcloud spanner instances update mit dem Flag --update-labels aus:

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

Wenn Sie bestimmte Labels aus einer vorhandenen Instanz entfernen möchten, verwenden Sie das Flag --remove-labels:

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

So löschen Sie alle Labels aus einer vorhandenen Instanz--clear-labels:

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 sie verwenden, um Ihre Kosten zu analysieren. Die Labels werden an Ihre Kostendaten weitergeleitet, sodass Sie Gebühren filtern und gruppieren können.

Kosten in Abrechnungsberichten nach Labels gruppiert ansehen

Sie können Ihre Spanner-Kosten, gruppiert nach Labelschlüsseln, 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 Rechnungskonto aus und klicken Sie im Navigationsbereich auf Berichte.
  3. Führen Sie im Bereich Filter folgende Schritte aus:
    1. Wählen Sie unter Dienste die Option Cloud Spanner aus, um die Kosten für Ihre Spanner-Datenbank zu isolieren.
    2. Wählen Sie unter Gruppieren nach die Option Labelschlüssel und dann 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 jedem Labelwert (z. B. environment:prod und environment:dev oder instance_id:my-instance-1 und instance_id:my-instance-2).