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

Network Analyzer utilizza i comandi del Recommender. Il motore per suggerimenti è un servizio Google Cloud che fornisce suggerimenti di utilizzo per prodotti e servizi Google Cloud. Per un elenco completo dei tipi di insight del motore per suggerimenti, consulta i tipi di insight del motore per suggerimenti.

Richiedi approfondimenti

gcloud

Per elencare gli insight per un progetto Google Cloud, 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 elencare gli approfondimenti, come 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 da 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 di 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.

    La dimensione predefinita della pagina è determinata dal servizio, altrimenti non è previsto il paging. Il paging potrebbe essere applicato prima o dopo FILTER e LIMIT.

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

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

API

Per ottenere insight per un progetto Google Cloud, effettua 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 la quale elencare gli approfondimenti, come 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.

L'esempio seguente mostra una risposta di esempio per il 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 determinato insight, 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'approfondimento da descrivere.
  • PROJECT_ID: l'ID del progetto contenente l'insight.
  • LOCATION: la località per la quale elencare gli approfondimenti.
  • INSIGHT_TYPE: il tipo di insight di Network Analyzer, come 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 approfondimento, effettua 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, come google.networkanalyzer.vpcnetwork.connectivityInsight.

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

  • INSIGHT_ID: l'ID dell'approfondimento.

Gruppi e tipi di insight

Per ulteriori informazioni sugli insight di Network Analyzer, consulta Gruppi e tipi di Insight.