Recommender-Befehlszeile und -API 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 in den 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: Projekt-ID, die Sie verwenden möchten für die Sie die Statistiken abrufen können. Sie können auch alle Statistiken für einen Ordner, eine Organisation oder ein Abrechnungskonto auflisten.
• LOCATION: Der Standort, für den Statistiken aufgeführt werden sollen, z. B. global, europe, asia-east1 oder us-central1-a.

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

  Eine vollständige Liste der Insight-Typen finden Sie unter Insight-Gruppen 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 für pro Seite aufgelistet.

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

• INSIGHT_TYPE: Der zu listende Network Analyzer-Erkenntnistyp, z. B. google.networkanalyzer.vpcnetwork.connectivityInsight.

  Eine vollständige Liste der Insight-Typen finden Sie unter Insight-Gruppen 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 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 Insight-Gruppen und ‑Typen.

API

Zum Abrufen von Details zu einer Statistik 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: den Standort der Statistik.

• INSIGHT_TYPE: Der Typ der Network Analyzer-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.