Recommender CLI und API verwenden

Network Analyzer verwendet Recommender-Befehle. Eine vollständige Liste der Recommender-Insight-Typen finden Sie unter Recommender-Insight-Typen.

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 aufgeführt werden sollen, z. B. global, europe, asia-east1 oder us-central1-a.

  • INSIGHT_TYPE: Der Typ der Network Analyzer-Statistik, die angefordert werden soll, z. B. google.networkanalyzer.vpcnetwork.connectivityInsight.

    Eine vollständige Liste der Insight-Typen 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 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 durch Kommas getrennten 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, stellen 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 aufgeführt werden sollen, z. B. global, europe, asia-east1 oder us-central1-a.

  • INSIGHT_TYPE: der Typ des Network Analyzer-Insights, der aufgeführt werden soll, z. B. google.networkanalyzer.vpcnetwork.connectivityInsight.

    Eine vollständige Liste der Insight-Typen 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"
}

Insight-Details 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 Typ der Network Analyzer-Statistik, z. B. google.networkanalyzer.vpcnetwork.connectivityInsight.

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

API

Wenn Sie Details zu einer Statistik abrufen möchten, stellen 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 Standort der Statistik.

  • INSIGHT_TYPE: Der Typ der Network Analyzer-Statistik, z. B. google.networkanalyzer.vpcnetwork.connectivityInsight.

    Eine vollständige Liste der Insight-Typen 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.