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

Network Analyzer utilizza i comandi Recommender. Per un elenco completo dei tipi di insight del motore per suggerimenti, consulta i tipi di insight del motore per suggerimenti.

Richiedere approfondimenti

gcloud

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

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 approfondimenti. Puoi anche elencare tutti gli approfondimenti per una cartella, un'organizzazione o un account di fatturazione.
  • LOCATION: la località per cui elencare gli approfondimenti, ad esempio global, europe, asia-east1 o us-central1-a.

  • INSIGHT_TYPE: il tipo di approfondimento 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 documentazione gcloud topic filters.

  • 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 della pagina predefinite 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 separato da virgole di nomi delle chiavi dei campi in base a cui eseguire l'ordinamento per una risorsa.

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

API

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

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 cui elencare gli approfondimenti, 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"
}

Descrivere i dettagli dell'approfondimento

gcloud

Per elencare i dettagli di una particolare informazione, 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'approfondimento.
  • LOCATION: la località per cui elencare gli approfondimenti.

  • 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 richiesta GET al metodo projects.locations.insightTypes.insights:

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 posizione 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, vedi Gruppi e tipi di insight.