Recommender CLI und API verwenden

Sie können Statistiken zum Network Analyzer über die Recommender API oder die Google Cloud CLI aufrufen. In diesem Dokument wird beschrieben, wie Sie Statistiken für einen bestimmten Statistiktyp des Network Analyzer aufrufen.

Statistiken anfordern

gcloud

Führen Sie den folgenden Befehl aus, um Statistiken für ein Google Cloud Projekt aufzulisten:

gcloud recommender insights list \
    --project=PROJECT_ID \
    --location=LOCATION \
    --insight-type=INSIGHT_TYPE \
    --filter=EXPRESSION \
    --limit=LIMIT \
    --page-size=PAGE_SIZE \
    --sort-by=SORT_BY \
    --format=json

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Projekt-ID, für die Sie Statistiken auflisten möchten. Sie können auch alle Statistiken für einen Ordner, eine Organisation oder ein Abrechnungskonto auflisten.
  • LOCATION: der Standort, für den Statistiken aufgelistet werden sollen, z. B. global, europe, asia-east1 oder us-central1-a.

  • INSIGHT_TYPE: der Statistiktyp des Network Analyzer, der angefordert werden soll, z. B. google.networkanalyzer.vpcnetwork.connectivityInsight.

    Eine vollständige Liste der Statistiktypen finden Sie unter Statistikgruppen und -typen.

Die folgenden Felder sind optional:

  • EXPRESSION: Wenden Sie diesen booleschen Filter auf jede Ressource an, die Sie auflisten möchten.

    Wenn der Ausdruck als True ausgewertet wird, wird dieses Element aufgelistet. Weitere Informationen und Beispiele zu Filterausdrücken finden Sie unter run $ gcloud topic filters oder in der gcloud topic filters Dokumentation.

  • LIMIT: die maximale Anzahl von Ressourcen, die aufgelistet werden sollen. Die Standardanzahl der aufgelisteten Ressourcen ist unbegrenzt.

  • PAGE_SIZE: die maximale Anzahl von Ressourcen, die pro Seite aufgelistet werden sollen.

    Die Standardseitengröße wird vom Dienst bestimmt, ansonsten gibt es keine Seitenwechsel. Seitenwechsel können vor oder nach FILTER und LIMIT eingefügt werden.

  • SORT_BY: eine Liste von kommagetrennten Feldschlüsselnamen, nach denen für eine Ressource sortiert wird.

    Die Standardreihenfolge ist aufsteigend. Wenn Sie eine absteigende Reihenfolge angeben möchten, stellen Sie dem Feld ~ (eine Tilde) voran.

API

Wenn Sie Statistiken für ein Google Cloud Projekt abrufen möchten, senden Sie eine GET Anfrage an die projects.locations.insightTypes.insights Methode:

https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/insightTypes/INSIGHT_TYPE/insights

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Projekt-ID.
  • LOCATION: der Standort, für den Statistiken aufgelistet werden sollen, z. B. global, europe, asia-east1 oder us-central1-a.

  • INSIGHT_TYPE: der Statistiktyp des Network Analyzer, der aufgelistet werden soll, z. B. google.networkanalyzer.vpcnetwork.connectivityInsight.

    Eine vollständige Liste der Statistiktypen finden Sie unter Statistikgruppen und -typen.

Das folgende Beispiel zeigt eine Beispielantwort für diesen Befehl.

{
  "name": "projects/{project_number}/locations/{location}/insightTypes/google.networkanalyzer.hybridconnectivity.dynamicRouteInsight/insights/{insight_id}",
  "description": "Dynamic route is fully shadowed by a peering subnet route",
  "content": {
    "networkUri": "//compute.googleapis.com/projects/{project_id}/global/networks/{network_name}",
    "region": "{location}",
    "ipRange": "{ip_range}",
    "priority": 100,
    "nextHopUri": "//compute.googleapis.com/projects/{project_id}/regions/{location}/vpnTunnels/{tunnel_name}",
    "cloudRouterUri": "//compute.googleapis.com/projects/{project_id}/regions/{location}/routers/{router_name}",
    "shadowingRouteUris": [
      "//compute.googleapis.com/projects/{project_id}/global/routes/{route_name}"
    ],
    "shadowingRouteType": "PEERING_SUBNET"
  },
  "lastRefreshTime": "2022-09-15T21:10:57.187942979Z",
  "observationPeriod": "611870.625920374s",
  "stateInfo": {
    "state": "ACTIVE"
  },
  "category": "PERFORMANCE",
  "targetResources": [
    "//compute.googleapis.com/projects/{project_id}/regions/{location}/vpnTunnels/{tunnel_name}"
  ],
  "insightSubtype": "DYNAMIC_ROUTE_FULLY_SHADOWED",
  "severity": "MEDIUM"
}

Statistikdetails beschreiben

gcloud

Führen Sie den folgenden Befehl aus, um Details zu einer bestimmten Statistik aufzulisten:

gcloud recommender insights describe INSIGHT_ID \
    --project=PROJECT_ID \
    --location=LOCATION \
    --insight-type=INSIGHT_TYPE

Ersetzen Sie Folgendes:

  • INSIGHT_ID: die ID der zu beschreibenden Statistik.
  • PROJECT_ID: die ID des Projekts, das die Statistik enthält.
  • LOCATION: der Standort, für den Statistiken aufgelistet werden sollen.

  • INSIGHT_TYPE: der Statistiktyp des Network Analyzer für die Statistik, z. B. google.networkanalyzer.vpcnetwork.connectivityInsight.

    Eine vollständige Liste der Statistiktypen finden Sie unter Statistikgruppen und -typen.

API

Wenn Sie Details zu einer Statistik abrufen möchten, senden Sie eine GET Anfrage an die projects.locations.insightTypes.insights Methode:

https://recommender.googleapis.com/v1/projects/PROJECT/locations/LOCATION/insightTypes/INSIGHT_TYPE/insights/INSIGHT_ID

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Projekt-ID.
  • LOCATION: der Standort der Statistik.

  • INSIGHT_TYPE: der Statistiktyp des Network Analyzer für die Statistik, z. B. google.networkanalyzer.vpcnetwork.connectivityInsight.

    Eine vollständige Liste der Statistiktypen finden Sie unter Statistikgruppen und -typen.

  • INSIGHT_ID: die Statistik-ID für die Statistik.

Statistikgruppen und -typen

Weitere Informationen zu Statistiken des Network Analyzer finden Sie unter Statistikgruppen und -typen.