Befehlszeile und API von Recommender verwenden

Network Analyzer verwendet Recommender-Befehle. Recommender ist ein Google Cloud-Dienst mit Nutzungsempfehlungen für Google Cloud-Produkte und -Dienste. Eine vollständige Liste der Recommender-Statistiktypen finden Sie unter Recommender-Statistiktypen.

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 Rechnungskonto auflisten.
  • LOCATION: der Standort, für den Statistiken aufgelistet werden sollen, z. B. global, europe, asia-east1 oder us-central1-a

  • INSIGHT_TYPE: der anzufordernde Statistiktyp von Network Analyzer, 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. Für weitere Informationen und Beispiele zu Filterausdrücken führen Sie $ gcloud topic filters aus oder lesen Sie die Dokumentation zu gcloud topic filters an.

  • LIMIT: die maximale Anzahl der aufzulistenden Ressourcen; die Standardanzahl der aufgeführten 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 durch Kommas getrennten Feldschlüsselnamen, nach denen für eine Ressource sortiert werden soll.

    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 Methode projects.locations.insightTypes.insights:

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: 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 aufzulistende Statistiktyp von Network Analyzer, 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"
}

Details der Statistik 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 Network Analyzer-Statistiktyp der 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 Methode projects.locations.insightTypes.insights:

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: Projekt-ID.
  • LOCATION: der Speicherort der Statistik.

  • INSIGHT_TYPE: der Network Analyzer-Statistiktyp der 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 Network Analyzer-Statistiken finden Sie unter Statistikgruppen und -typen.