Dashboards per API erstellen und verwalten

In diesem Dokument wird beschrieben, wie Sie benutzerdefinierte Dashboards und die Widgets auf diesen Dashboards mithilfe der Ressource Dashboard in der Cloud Monitoring API erstellen und verwalten. Die Beispiele hier veranschaulichen, wie Sie Ihre Dashboards mithilfe von curl zum Aufrufen der API und sie zeigen, wie die Google Cloud CLI verwendet wird. Sie können Ihre benutzerdefinierten Dashboards auch über das Google Cloud Console können Sie die API eine programmatische Möglichkeit, viele Dashboards gleichzeitig zu verwalten.

Der Endpunkt unterstützt die folgenden Methoden zum Verwalten und Konfigurieren von Dashboards:

Sie können die API direkt mit dem Dienstprogramm curl oder der Methode Google Cloud CLI

Sie können die Daten nicht abrufen, bearbeiten oder löschen vordefinierte Dashboards.

Informationen zu Dashboards

Beim Erstellen eines Dashboards müssen Sie angeben, welche Komponenten oder Widgets angezeigt werden sollen. Außerdem müssen Sie das Layout für diese Widgets festlegen. Sie können auch Fügen Sie Ihrem Dashboard Labels und Filter hinzu. Labels können Ihnen helfen, ein Dashboard zu finden oder den Inhaltstyp auf dem Dashboard anzugeben.

Dashboard-Layouts

Layouts definieren die Reihenfolge der Komponenten eines Dashboards. Die API stellt die folgenden Layouts zur Verfügung:

  • GridLayout: Teilt den verfügbaren Platz in vertikale Spalten mit gleicher Breite und ordnet einen Satz von Widgets mit einer Strategie an, bei der zuerst die Zeilen berücksichtigt werden (Row-first).

  • MosaicLayout: Teilt den verfügbaren Speicherplatz in ein Raster. Jedes Widget kann einen oder mehrere Rasterblöcke einnehmen.

  • RowLayout: Teilt den verfügbaren Platz in Zeilen und ordnet einen Satz von Widgets horizontal in jeder Zeile an.

  • ColumnLayout: Teilt den verfügbaren Platz in vertikale Spalten und ordnet einen Satz von Widgets vertikal in jeder Spalte an.

Im Folgenden wird die JSON-Darstellung eines Dashboards in RowLayout mit drei Text-Widgets dargestellt:

{
  "displayName": "Row-layout example",
  "rowLayout": {
    "rows": [
      {
        "widgets": [
          {
            "text": {
              "content": "Text Widget 1",
              "format": "RAW"
            }
          },
          {
            "text": {
              "content": "**Text Widget 2**",
              "format": "MARKDOWN"
            }
          },
          {
            "text": {
              "content": "_Text Widget 3_",
              "format": "MARKDOWN"
            }
          }
        ]
      }
    ]
  }
}

Dashboardwidgets

Ein Widget enthält eine einzelne Dashboard-Komponente und die Konfiguration, wie die Komponente im Dashboard dargestellt wird. Ein Dashboard kann mehrere Widgets enthalten. Es gibt mehrere Arten von Widget-Objekten:

  • Im Widget XyChart werden Daten über die X- und Y-Achse dargestellt.

    Dieses Widget zeigt ein Dataset an, oder durch eine SQL-Abfrage generiert wurden. Mit diesem Widget können Sie die Diagrammdaten entweder der linken oder der rechten Y-Achse zuordnen. Wenn mehrere Messwerttypen in einem Diagramm dargestellt werden, können Sie beide Y-Achsen verwenden. Das XyChart-Widget unterstützt die folgenden Darstellungsstile:

    • Liniendiagramme
    • Balkendiagramme
    • Gestapelte Flächendiagramme
    • Heatmaps

  • Widgets, die Daten aus einer Dimension enthalten, z. B. den letzten Wert:

    • PieChart: Hier werden die aktuellen Werte einer Sammlung von Zeitreihen angezeigt. Jede Zeitreihe trägt einen Tortenstück zum Ganzen bei.

    • Scorecard: Zeigt den aktuellsten Wert einer Zeitreihe an und wie sich dieser Wert auf einen oder mehrere Grenzwerte bezieht.

    • TimeSeriesTable: Zeigt den aktuellsten Wert oder einen aggregierten Wert für jede Zeitreihe an. Tabellen unterstützen die Anpassung. Sie können beispielsweise Zellen farblich codieren und Spaltennamen und Datenausrichtung konfigurieren.

  • Widgets, die Benachrichtigungsrichtlinien oder Informationen zum Vorfall anzeigen:

    • AlertChart: Zeigt eine Zusammenfassung einer Benachrichtigungsrichtlinie mit einer einzelnen Bedingung an. In diesem Widget werden Daten als Liniendiagramm dargestellt. Außerdem sind der Grenzwert und die Anzahl der offenen Vorfälle zu sehen.

    • IncidentList: Zeigt eine Liste von Vorfällen an. Sie können das Widget so konfigurieren, dass Vorfälle für bestimmte Benachrichtigungsrichtlinien oder für bestimmte Ressourcentypen angezeigt werden.

  • Widgets, die Logeinträge und Fehler anzeigen:

  • Text- und Organisations-Widgets:

    • CollapsibleGroup: Zeigt eine Sammlung von Widgets an. Sie können die Ansicht einer Gruppe minimieren.

    • SingleViewGroup: zeigt ein Widget in einem Widget-Sammlung. Sie können auswählen, welches Widget angezeigt werden soll.

    • SectionHeader: Erstellt eine horizontale Trennlinie Ihr Dashboard und es wird ein Eintrag in der Tabelle des Dashboards Inhalte.

    • Text: Zeigt den Textinhalt entweder als Rohtext oder als Markdown-String an.

    Um die Text- und Organisations-Widgets auf einer Dashboard muss eine MosaicLayout vorhanden sein.

Zusätzlich zu diesen Objekten können Sie auch einen leeren Platzhalter zu einem Dashboard hinzufügen.

Im Folgenden sehen Sie beispielsweise die JSON-Darstellung eines XyChart-Widget, dessen rechte Y-Achse konfiguriert ist:

{
  "displayName": "Demo dashboard",
  "gridLayout": {
    "widgets": [
      {
        "title": "Sample line chart",
        "xyChart": {
          "dataSets": [
            {
              "timeSeriesQuery": {
                "timeSeriesFilter": {
                  "filter": "metric.type=\"compute.googleapis.com/instance/cpu/utilization\" resource.type=\"gce_instance\"",
                  "aggregation": {
                    "perSeriesAligner": "ALIGN_MEAN",
                    "crossSeriesReducer": "REDUCE_MAX",
                    "groupByFields": [
                      "resource.label.zone"
                    ]
                  }
                },
                "unitOverride": "1"
              },
              "plotType": "LINE"
            }
          ],
          "timeshiftDuration": "0s",
          "yAxis": {
            "label": "y1Axis",
            "scale": "LINEAR"
          },
          "chartOptions": {
            "mode": "COLOR"
          }
        }
      }
    ]
  }
}

Dashboardlabels

Mit Labels können Sie Ihre Dashboards verwalten und organisieren. Sie können beispielsweise das Label prod hinzufügen, um anzugeben, dass im Dashboard Zeitreihendaten und Logdaten für Ihre Produktionsressourcen angezeigt werden. Alternativ können Sie können Sie das Label playbook hinzufügen, um anzuzeigen, enthält Informationen zur Fehlerbehebung.

Das Hinzufügen von Labels zu einem Dashboard ist optional.

Das folgende Beispiel zeigt ein Dashboard-Objekt, das gibt das Label playbook an.

{
  "displayName": "Example",
  "mosaicLayout": {
    "columns": 12,
    "tiles": [
      ...
    ]
  },
  "dashboardFilters": [],
  "labels": {
    "playbook": ""
  }
}

Wie das vorherige Beispiel zeigt, wird das Feld labels als map implementiert. Die Felder key und value sind Strings. Wenn Sie eine einem Dashboard, legen Sie für key den Namen des Labels fest und value in einen leeren String.

Dashboard-Filter

Beim Entwerfen eines Dashboards identifizieren Sie möglicherweise mehrere Möglichkeiten, Daten, die im Dashboard angezeigt werden. Angenommen, in einem Dashboard werden Zeitreihendaten für Ihre VM-Instanzen angezeigt. Vielleicht möchtest du um die Zeitreihendaten für alle VMs anzusehen. Vielleicht möchten Sie die sich in einer bestimmten Zone befinden. In dieser empfehlen wir, einen dauerhaften Filter zu erstellen und die Standardfiltereinstellung dieses Filters in die am häufigsten verwendete Datenansicht ein. Dauerhafte Filter können auf einige oder alle Dashboard-Widgets angewendet werden. Wenn Sie das Dashboard mit der In der Google Cloud Console werden in der Dashboard-Symbolleiste Ihre permanenten Filter und ein Menü, mit dem Sie den Wert des Filters vorübergehend ändern können.

Es gibt mehrere Arten von dauerhaften Dashboard-Filtern:

  • Dashboardweite Filter gelten für alle Widgets auf einem Dashboard, die die Filterlabel und keinen Wert für dieses Label angeben.

    Wenn ein Diagramm beispielsweise den Filter zone = us-central1-a enthält, wird ein Dashboard-Filter, der auf dem Label zone basiert, ignoriert. In ähnlicher Weise Diagramme ohne zone-Label ignorieren Dashboard-Filter mit diesem Label.

  • Vorlagenvariablen sind benannte Variablen, die für bestimmte Widgets gelten. Jede Variable bezieht sich auf ein bestimmtes Label und einen bestimmten Wert. Sie bestimmen, Widgets, für die eine Vorlagenvariable gilt.

Alle Filtertypen haben dieselbe Datenstruktur. Weitere Informationen finden Sie unter DashboardFilter.

Das folgende Beispiel zeigt die teilweise JSON-Darstellung eines Dashboards definiert eine Vorlagenvariable und einen Dashboard-weiten Filter:

{
  "dashboardFilters": [
      {
        "filterType": "RESOURCE_LABEL",
        "labelKey": "instance_id",
        "stringValue": "3133577226154888113",
        "templateVariable": "iid"
      },
      {
        "filterType": "RESOURCE_LABEL",
        "labelKey": "zone"
      }
    ],
  "displayName": "Illustrate Template Variables",
  ...

Im angezeigten JSON-Code bezieht sich der erste Eintrag in der dashboardFilters-Struktur auf eine Vorlagenvariable mit dem Namen iid und einen dashboardweiten Filter mit dem Labelschlüssel zone. Die Vorlagenvariable ist ein Alias des Labels instance_id.

In der Datenstruktur einer Vorlagenvariablen werden die Widgets nicht aufgeführt, angewandt wird. Stattdessen verknüpfen Sie ein Widget mit einer Vorlagenvariablen, indem Sie die Abfrage des Widgets ändern, sodass sie einen Verweis auf die Variable enthält. Wenn das Widget auf dem Dashboard angezeigt wird, wird der Wert der Vorlagenvariablen aufgelöst.

In den folgenden Abschnitten erfahren Sie, wie Sie Logbereiche und Diagramme mit Anmerkungen versehen:

Logbereich

Wenn Sie einen Logbereich so konfigurieren möchten, dass die Anzeige basierend auf dem Wert einer Vorlagenvariablen gefiltert wird, fügen Sie die Variable dem Abfragebereich hinzu. Im folgenden Beispiel wird eine Abfrage veranschaulicht, die nach dem Wert der Vorlagenvariablen iid filtert:

${iid}

Bevor das Logfeld die anzuzeigenden Logs abfragt, gelöst wird. Wenn der Wert der Vorlagenvariablen in diesem Beispiel "12345" ist, wird ${iid} durch die Anweisung resource.labels."instance_id"="12345" ersetzt.

Sie können auch nur den Wert einer Vorlagenvariablen in eine Abfrage einbeziehen. Wir empfehlen, den Wert nur als Teil eines Filters zu verwenden, der mit einem regulärer Ausdruck. In der folgenden Abfrage wird beispielsweise mit einem regulären Ausdruck nach Logeinträgen gesucht, deren JSON-Nutzlast den beschriebenen String enthält:

jsonPayload.message=~"Connected to instance: ${iid.value}"

Wenn Sie eine Abfrage für den Logbereich konfiguriert und dann die Schaltfläche zum Öffnen des Log-Explorers ausgewählt haben, werden die Vorlagenvariablen aufgelöst, bevor der Log-Explorer geöffnet wird.

In der folgenden Tabelle wird gezeigt, wie die Vorlagenvariable vom Bereich „Protokolle“ aufgelöst wird:

Syntax Ausgewählter
Wert		 Ausdruck im Bereich „Logs“ aufgelöst
${iid} 12345 resource.labels."instance_id"="12345"
${iid} * ""
${iid.value} 12345 12345
${iid.value} * .*

Mit MQL definierte Diagramme und Tabellen

Wenn Sie ein Diagramm mit Monitoring Query Language (MQL) konfigurieren, hängen Sie dem Abfragestring ein Pipe und die Variable an:

fetch gce_instance
| metric 'compute.googleapis.com/instance/cpu/utilization'
| every 1m
| ${iid}

Bevor das Diagramm die anzuzeigende Zeitreihe abfragt, wird die Vorlagenvariable gelöst wird. Wenn der Wert der Vorlagenvariablen in diesem Beispiel "12345" ist, wird ${iid} durch die Anweisung filter (resource.instance_id == '12345') ersetzt. Dieser Filter entspricht der Zeit mit dem Label resource.instance_id und nur wenn der Wert dieses Labels ist genau 12345.

Wenn Sie Zeitreihen mithilfe eines regulären Ausdrucks filtern möchten, dann: konfigurieren Sie die Abfrage so, dass sie nur den Wert der Vorlagenvariablen enthält. Zur Veranschaulichung der Syntax wird im Folgenden gezeigt, wie mit einem regulären Ausdruck ermittelt wird, ob der Wert des Labels resource.instance_id den Wert der Vorlagenvariablen iid enthält:

fetch gce_instance
| metric 'compute.googleapis.com/instance/cpu/utilization'
| filter resource.instance_id=~"${iid.value}"
| group_by 1m, [value_utilization_mean: mean(value.utilization)]
| every 1m

In der folgenden Tabelle wird gezeigt, wie die Vorlagenvariable für MQL-Abfragen aufgelöst wird:

Syntax Selected
Value		 Aufgelöster MQL-Ausdruck
${iid} 12345 filter (resource.instance_id == '12345')
${iid} * filter (true)
${iid.value} 12345 12345
${iid.value} * .*

PromQL-definierte Diagramme und Tabellen

Wenn Sie ein Diagramm mit PromQL definieren, hängen Sie an den Abfragestring den Variable in geschweiften Klammern:

compute_googleapis_com:instance_cpu_utilization {
    project_id="my-project", ${iid}
}

Bevor das Diagramm die anzuzeigende Zeitreihe abfragt, wird die Vorlagenvariable gelöst wird. Wenn in diesem Beispiel der Wert der Vorlagenvariablen ist "12345", dann wird ${iid} durch die Anweisung ersetzt instance_id == '12345'

Ähnlich wie bei MQL wird die Abfrage, wenn Sie ein Widget mit PromQL definieren, nur den Wert der Vorlagenvariablen extrahieren kann. Wir empfehlen Ihnen, Verwenden Sie den Wert nur als Teil eines Filters, der mit einem regulären Ausdruck definiert ist. Bis um die Syntax zu veranschaulichen. Im Folgenden wird gezeigt, wie Sie mit einem regulären Ausdruck Ermittelt, ob der Wert des Labels instance_id den Wert des Attributs Vorlagenvariable iid:

compute_googleapis_com:instance_cpu_utilization{
    instance_id=~"${iid.value}"
}

Die folgende Tabelle zeigt, wie die Vorlagenvariable für PromQL aufgelöst wird Suchanfragen:

Syntax Selected
Value		 PromQL-Ausdruck aufgelöst
${iid} 12345 instance_id == '12345'
${iid} * noop_filter=~".*"
${iid.value} 12345 12345
${iid.value} * .+

Mit Zeitreihenfiltern definierte Diagramme und Tabellen

Wenn Sie ein Diagramm mit Zeitreihenfiltern definieren, hängen Sie die Variable zum Filterstring an:

"filter": "metric.type=\"compute.googleapis.com/instance/cpu/utilization\"
           resource.type=\"gce_instance\" ${iid}"

Im Gegensatz zu MQL- und PromQL-definierten Diagrammen können Sie den Wert einer Vorlagenvariablen nicht in einem Zeitreihenfilter verwenden.

In der folgenden Tabelle wird gezeigt, wie die Vorlagenvariable aufgelöst wird:

Syntax Selected
Value		 Aufgelöster Filterausdruck
${iid} 12345 resource.instance_id == "12345"
${iid} * Ausgelassen
${iid.value} 12345 Nicht unterstützt
${iid.value} * Nicht unterstützt

Dashboard erstellen

Zum Erstellen eines neuen benutzerdefinierten Dashboards rufen Sie dieMethode dashboards.create auf und geben das Layout und die Widgets zur Anzeige im Dashboard an.

Wenn Sie ein Dashboard erstellen, generiert die API automatisch die dashboard_id. Wenn Sie eine benutzerdefinierte dashboard_id angeben möchten, können Sie das name-Feld eines Dashboard-Objekts festlegen. Das Format des Namensfelds sieht so aus:

"name": "projects/${PROJECT_ID}/dashboards/${DASHBOARD_ID}"

Protokoll

Um ein neues Dashboard zu erstellen, senden Sie eine POST-Anfrage an den Endpunkt Dashboard.

curl -d @my-dashboard.json -H "Authorization: Bearer $ACCESS_TOKEN" -H 'Content-Type: application/json' -X POST https://monitoring.googleapis.com/v1/projects/${PROJECT_ID}/dashboards

gcloud

Um ein Dashboard in einem Projekt zu erstellen, verwenden Sie die gcloud monitoring dashboards create-Befehl.

gcloud monitoring dashboards create --config-from-file=my-dashboard.json

So duplizieren Sie beispielsweise ein Dashboard:

  1. Führen Sie die Schritte unter Dashboard abrufen aus, um die Definition des ursprünglichen Dashboards herunterzuladen.
  2. Bearbeiten Sie die zurückgegebene JSON-Datei, um die Felder etag und name zu entfernen, und ändern Sie den Wert des Felds displayName.
  3. Führen Sie den Befehl aus, um das Dashboard zu erstellen.

Weitere Informationen finden Sie in der Referenz zu gcloud monitoring dashboards create.

In den Beispielen wird ein Beispiel-Dashboard mithilfe der Datei my-dashboard.json erstellt. Sie können Ihr Dashboard über die Google Cloud Console verwalten.

Weitere Dashboard-Konfigurationen finden Sie unter Beispiele für Dashboards und Layouts.

Dashboards löschen

Um ein benutzerdefiniertes Dashboard zu löschen, rufen Sie die Methode dashboards.delete auf und geben Sie das zu löschende Dashboard an.

Protokoll

Senden Sie zum Löschen eines benutzerdefinierten Dashboards eine DELETE-Anfrage an den Endpunkt Dashboard, der mit der ID des zu löschenden Dashboards qualifiziert ist.

curl -H "Authorization: Bearer $ACCESS_TOKEN" -X DELETE https://monitoring.googleapis.com/v1/projects/${PROJECT_ID}/dashboards/${DASHBOARD_ID}

Bei Erfolg gibt die Methode eine leere Antwort zurück. Andernfalls wird ein Fehler zurückgegeben.

gcloud

Verwenden Sie zum Löschen eines benutzerdefinierten Dashboards gcloud monitoring dashboards delete und geben Sie die vollständig qualifizierte ID des zu löschenden Dashboards an:

gcloud monitoring dashboards delete projects/${PROJECT_ID}/dashboards/${DASHBOARD_ID}

Weitere Informationen finden Sie in der Referenz zu gcloud monitoring dashboards delete.

Dashboards auflisten

Zum Auflisten aller Dashboards, die zu einem Projekt gehören, rufen Sie die Methode dashboards.list auf und geben die Projekt-ID an.

Protokoll

Wenn Sie alle benutzerdefinierten Dashboards eines Projekts auflisten möchten, senden Sie die Projekt-ID an den Endpunkt Dashboard.

curl -H "Authorization: Bearer $ACCESS_TOKEN" https://monitoring.googleapis.com/v1/projects/${PROJECT_ID}/dashboards

gcloud

Um alle benutzerdefinierten Dashboards eines Projekts aufzulisten, verwenden Sie den gcloud monitoring dashboards list-Befehl:

gcloud monitoring dashboards list

Weitere Informationen finden Sie in der Referenz zu gcloud monitoring dashboards list.

Die Beispiele geben die mit Ihrem Projekt verknüpften benutzerdefinierten Dashboards zurück.

Listenantwort paginieren

Die dashboards.list-Methode unterstützt die Paginierung, sodass Sie die Ergebnisse jeweils pro Seite statt alle gleichzeitig verarbeiten können.

Protokoll

Geben Sie für die erste Seite der Ergebnisliste den Suchparameter pageSize mit der Anfrage an:

curl -H "Authorization: Bearer $ACCESS_TOKEN" https://monitoring.googleapis.com/v1/projects/${PROJECT_ID}/dashboards?page_size=1

Die Methode gibt die erste Seite der Liste und das nextPageToken zurück. Beispiel:

{
  "dashboards" : [
    {
       "displayName" : "Grid Layout Example",
       "gridLayout" : {
         "widgets" : [
            { ... },
            { ... },
            { ... },
          ]
       }
    }
  ]
},
"nextPageToken": "ChYqFDEyMzkzMzUwNzg0OTE1MDI4MjM3"

Für jede verbleibende Seite müssen Sie das entsprechende nextPageToken in der Anfrage angeben.

gcloud

Um die Anzahl der Ressourcen pro Seite anzugeben, übergeben Sie das Flag --page-size mit dem Befehl. Beispiel:

gcloud monitoring dashboards list --page-size=1

Dashboard abrufen

Wenn Sie ein bestimmtes benutzerdefiniertes Dashboard für ein Projekt abrufen möchten, rufen Sie die Methode dashboards.get auf, die mit der Dashboard-ID qualifiziert ist.

Protokoll

Wenn Sie ein bestimmtes benutzerdefiniertes Dashboard abrufen möchten, senden Sie die Dashboard-ID an den Endpunkt Dashboard.

curl -H "Authorization: Bearer $ACCESS_TOKEN" https://monitoring.googleapis.com/v1/projects/${PROJECT_ID}/dashboards/${DASHBOARD_ID}

Die Methode gibt eine Antwort in etwa wie im folgenden Beispiel zurück:

{
  "columnLayout": {
    "columns": [
      {
        "widgets": [
          {
            "text": {
              "content": "Text Widget 1",
              "format": "RAW"
            }
          },
          {
            "text": {
              "content": "**Text Widget 2**",
              "format": "MARKDOWN"
            }
          },
          {
            "text": {
              "content": "_Text Widget 3_",
              "format": "MARKDOWN"
            }
          }
        ]
      }
    ]
  },
  "displayName": "Column-layout example",
  "etag": "cb3070baf15de7c79d78761baac3a386",
  "name": "projects/730041941835/dashboards/e4cd063e-5414-4e07-9e1e-450d6d3a531d"
}

gcloud

Um ein bestimmtes benutzerdefiniertes Dashboard abzurufen, verwenden Sie den Befehl gcloud monitoring dashboards describe und geben die Dashboard-ID an:

gcloud monitoring dashboards describe ${DASHBOARD_ID} --format=json

Der Befehl gibt das angeforderte Dashboard zurück:

{
  "columnLayout": {
    "columns": [
      {
        "widgets": [
          {
            "text": {
              "content": "Text Widget 1",
              "format": "RAW"
            }
          },
          {
            "text": {
              "content": "**Text Widget 2**",
              "format": "MARKDOWN"
            }
          },
          {
            "text": {
              "content": "_Text Widget 3_",
              "format": "MARKDOWN"
            }
          }
        ]
      }
    ]
  },
  "displayName": "Column-layout example",
  "etag": "cb3070baf15de7c79d78761baac3a386",
  "name": "projects/730041941835/dashboards/e4cd063e-5414-4e07-9e1e-450d6d3a531d"
}

Weitere Informationen finden Sie in der Referenz zu gcloud monitoring dashboards describe.

Dashboard aktualisieren

Rufen Sie zum Aktualisieren eines vorhandenen benutzerdefinierten Dashboards die Methode dashboards.patch auf. Zum Abrufen des aktuellen etag-Werts können Sie die Methode dashboards.get aufrufen und ihn in der Antwort finden.

Protokoll

Senden Sie zum Aktualisieren eines benutzerdefinierten Dashboards eine PATCH-Anfrage an den Endpunkt Dashboard und geben Sie das überarbeitete Dashboard-Objekt und den etag-Wert aus der letzten dashboards.get-Antwort.

curl -d @my-updated-dashboard.json -H "Authorization: Bearer $ACCESS_TOKEN" -H 'Content-Type: application/json' -X PATCH https://monitoring.googleapis.com/v1/projects/${PROJECT_ID}/dashboards/${DASHBOARD_ID}

gcloud

Verwenden Sie zum Aktualisieren eines benutzerdefinierten Dashboards gcloud monitoring dashboards update: Geben Sie an Die ID des zu aktualisierenden Dashboards und stellen die Änderungen im Dashboard bereit.

gcloud monitoring dashboards update ${DASHBOARD_ID} --config-from-file=my-updated-dashboard.json

Weitere Informationen finden Sie in der Referenz zu gcloud monitoring dashboards update.

Die Beispiele aktualisieren ein vorhandenes benutzerdefiniertes Dashboard mithilfe der Datei my-updated-dashboard.json und geben eine Kopie des aktualisierten Dashboard-Eintrags zurück. Die zurückgegebenen Daten enthalten einen neuen etag-Wert.

Nächste Schritte