Usar a CLI e a API do recomendador

O Network Analyzer usa comandos do recomendador. O recomendador é um serviço do Google Cloud que fornece recomendações de uso para produtos e serviços do Google Cloud. Para ver 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 o seguinte 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 em que os insights serão listados, 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 ver 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, esse 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 haverá paginação. A paginação pode ser aplicada antes ou depois de FILTER e LIMIT.

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

    A ordem padrão é crescente. Para especificar uma ordem decrescente, prefixe um campo com ~ (um til).

API

Para ver insights de um projeto do Google Cloud, faça uma solicitação GET para o 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 em que os insights serão listados, como global, europe, asia-east1 ou us-central1-a.

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

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

O exemplo a seguir mostra uma resposta de amostra para este 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"
}

Descreva detalhes do insight

gcloud

Para listar detalhes de um insight específico, execute o seguinte 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 insights serão listados.

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

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

API

Para ver detalhes sobre um insight, faça uma solicitação GETpara o 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 ver 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 insights do Network Analyzer, consulte Grupos e tipos do Insight.