Utilizzare l'interfaccia a riga di comando e l'API del motore per suggerimenti

Puoi utilizzare l'API Recommender o Google Cloud CLI per visualizzare gli insight di Network Analyzer. Questo documento mostra come visualizzare gli insight per un tipo di insight di Network Analyzer specifico.

Richiedi insight

gcloud

Per elencare gli insight per un Google Cloud progetto, esegui questo comando:

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto per il quale vuoi elencare gli insight. Puoi anche elencare tutti gli insight per una cartella, un'organizzazione o un account di fatturazione.
  • LOCATION: la località per la quale vuoi elencare gli insight, ad esempio global, europe, asia-east1 o us-central1-a.

  • INSIGHT_TYPE: il tipo di insight di Network Analyzer da richiedere, ad esempio google.networkanalyzer.vpcnetwork.connectivityInsight.

    Per un elenco completo dei tipi di insight, consulta Gruppi e tipi di insight.

I seguenti campi sono facoltativi:

  • EXPRESSION: applica questo filtro booleano a ogni risorsa che vuoi elencare.

    Se l'espressione restituisce True, l'elemento viene elencato. Per ulteriori dettagli ed esempi di espressioni di filtro, esegui $ gcloud topic filters o consulta la gcloud topic filters documentazione.

  • LIMIT: il numero massimo di risorse da elencare; il numero predefinito di risorse elencate è illimitato.

  • PAGE_SIZE: il numero massimo di risorse da elencare per pagina.

    Le dimensioni predefinite della pagina sono determinate dal servizio; in caso contrario, non è presente alcuna paginazione. La paginazione potrebbe essere applicata prima o dopo FILTER e LIMIT.

  • SORT_BY: un elenco di nomi delle chiavi dei campi separati da virgole in base ai quali ordinare una risorsa.

    L'ordine predefinito è crescente. Per specificare un ordine decrescente, anteponi ~ (una tilde) a un campo.

API

Per ottenere insight per un Google Cloud progetto, invia una GET richiesta al projects.locations.insightTypes.insights metodo:

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto.
  • LOCATION: la località per la quale vuoi elencare gli insight, ad esempio global, europe, asia-east1 o us-central1-a.

  • INSIGHT_TYPE: il tipo di insight di Network Analyzer da elencare, ad esempio google.networkanalyzer.vpcnetwork.connectivityInsight.

    Per un elenco completo dei tipi di insight, consulta Gruppi e tipi di insight.

Il seguente esempio mostra una risposta di esempio per questo comando:

{
  "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"
}

Descrivi i dettagli dell'insight

gcloud

Per elencare i dettagli di un insight specifico, esegui questo comando:

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

Sostituisci quanto segue:

  • INSIGHT_ID: l'ID dell'insight da descrivere.
  • PROJECT_ID: l'ID del progetto contenente l'insight.
  • LOCATION: la località per la quale vuoi elencare gli insight.

  • INSIGHT_TYPE: il tipo di insight di Network Analyzer, ad esempio google.networkanalyzer.vpcnetwork.connectivityInsight.

    Per un elenco completo dei tipi di insight, consulta Gruppi e tipi di insight.

API

Per ottenere i dettagli di un insight, invia una GET richiesta al projects.locations.insightTypes.insights metodo:

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto.
  • LOCATION: la località dell'insight.

  • INSIGHT_TYPE: il tipo di insight di Network Analyzer, ad esempio google.networkanalyzer.vpcnetwork.connectivityInsight.

    Per un elenco completo dei tipi di insight, consulta Gruppi e tipi di insight.

  • INSIGHT_ID: l'ID dell'insight.

Gruppi e tipi di insight

Per saperne di più sugli insight di Network Analyzer, consulta Gruppi e tipi di insight.