Usar a CLI e a API Recommender

O Network Analyzer usa comandos do recomendador. Para uma lista completa dos tipos de insight do recomendador, consulte este link.

Solicitar insights

gcloud

Para listar insights de um projeto do Google Cloud , execute este 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

Substitua:

  • PROJECT_ID: o ID do projeto para o qual você quer listar insights. Também é possível listar todos os insights de uma pasta, organização ou conta de faturamento.
  • LOCATION: o local para o qual listar insights, como global, europe, asia-east1 ou us-central1-a.

  • INSIGHT_TYPE: o tipo de insight do Network Analyzer a ser solicitado, como google.networkanalyzer.vpcnetwork.connectivityInsight.

    Para uma lista completa dos tipos de insight, consulte Grupos e tipos de insight.

Os seguintes campos são opcionais:

  • EXPRESSION: aplique esse filtro booleano a cada recurso que você quer listar.

    Se a expressão for avaliada como True, o item será listado. Para mais detalhes e exemplos de expressões de filtro, execute $ gcloud topic filters ou consulte a documentação de gcloud topic filters.

  • LIMIT: o número máximo de recursos a serem listados. O número padrão de recursos listados é ilimitado.

  • PAGE_SIZE: o número máximo de recursos a serem listados por página.

    O tamanho da página padrão é determinado pelo serviço. Caso contrário, não há paginação. A paginação pode ser aplicada antes ou depois de FILTER e LIMIT.

  • SORT_BY: uma lista de nomes de chaves de campo separados por vírgulas para ordenar de acordo com um recurso.

    A ordem padrão é crescente. Para especificar uma ordem decrescente, inclua o prefixo ~ (um til) em um campo.

API

Para receber insights de um projeto do Google Cloud , faça uma solicitação GET ao método projects.locations.insightTypes.insights:

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

Substitua:

  • PROJECT_ID: o ID do projeto.
  • LOCATION: o local para o qual listar insights, como global, europe, asia-east1 ou us-central1-a.

  • INSIGHT_TYPE: o tipo de insight do Network Analyzer a ser listado, como google.networkanalyzer.vpcnetwork.connectivityInsight.

    Para uma lista completa dos tipos de insight, consulte Grupos e tipos de insight.

Este exemplo mostra uma resposta de amostra para o 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"
}

Descrever detalhes do insight

gcloud

Para listar os detalhes de um insight específico, execute este comando:

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

Substitua:

  • INSIGHT_ID: o ID do insight a ser descrito.
  • PROJECT_ID: o ID do projeto que contém o insight.
  • LOCATION: o local para o qual listar insights.

  • INSIGHT_TYPE: o tipo do insight do Network Analyzer, como google.networkanalyzer.vpcnetwork.connectivityInsight.

    Para uma lista completa dos tipos de insight, consulte Grupos e tipos de insight.

API

Para acessar os detalhes de um insight, faça uma solicitação GET ao método projects.locations.insightTypes.insights:

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

Substitua:

  • PROJECT_ID: o ID do projeto.
  • LOCATION: o local do insight.

  • INSIGHT_TYPE: o tipo do insight do Network Analyzer, como google.networkanalyzer.vpcnetwork.connectivityInsight.

    Para uma lista completa dos tipos de insight, consulte Grupos e tipos de insight.

  • INSIGHT_ID: o ID do insight.

Grupos e tipos de insight

Para mais informações sobre os insights do Network Analyzer, consulte Grupos e tipos de insight.