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

Network Analyzer utilizza i comandi di Recommender. Per un elenco completo dei tipi di insight di Recommender, consulta la sezione Tipi di insight di Recommender .

Richiedi insight

gcloud

Per elencare gli insight di un Google Cloud progetto, esegui il seguente 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 di 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, la voce viene elencata. 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 a cui eseguire l'ordinamento per 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 degli insight

gcloud

Per elencare i dettagli di un insight specifico, esegui il seguente 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.