Use a API e a CLI do Recommender

O analisador de rede usa comandos do Recommender. Para ver uma lista completa dos tipos de estatísticas do Recomendador, consulte os tipos de estatísticas do Recomendador.

Pedir estatísticas

gcloud

Para apresentar uma lista de estatísticas de um Google Cloud projeto, 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 o seguinte:

  • PROJECT_ID: o ID do projeto para o qual quer apresentar estatísticas. Também pode listar todas as estatísticas de uma pasta, uma organização ou uma conta de faturação.
  • LOCATION: a localização para listar estatísticas, como global, europe, asia-east1 ou us-central1-a.

  • INSIGHT_TYPE: o tipo de estatísticas do analisador de rede a pedir, como google.networkanalyzer.vpcnetwork.connectivityInsight.

    Para ver uma lista completa dos tipos de estatísticas, consulte o artigo Grupos e tipos de estatísticas.

Os seguintes campos são opcionais:

  • EXPRESSION: aplique este filtro booleano a cada recurso que quer listar.

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

  • LIMIT: o número máximo de recursos a listar; o número predefinido de recursos listados é ilimitado.

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

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

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

    A ordem predefinida é ascendente. Para especificar uma ordem descendente, adicione o prefixo ~ (um til) a um campo.

API

Para receber estatísticas de um Google Cloud projeto, faça um pedido GET ao método projects.locations.insightTypes.insights:

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

Substitua o seguinte:

  • PROJECT_ID: o ID do projeto.
  • LOCATION: a localização para listar estatísticas, como global, europe, asia-east1 ou us-central1-a.

  • INSIGHT_TYPE: o tipo de estatísticas do analisador de rede a apresentar, como google.networkanalyzer.vpcnetwork.connectivityInsight.

    Para ver uma lista completa dos tipos de estatísticas, consulte o artigo Grupos e tipos de estatísticas.

O exemplo seguinte mostra uma resposta de exemplo 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 os detalhes das estatísticas

gcloud

Para apresentar detalhes de uma estatística específica, execute o seguinte comando:

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

Substitua o seguinte:

  • INSIGHT_ID: o ID da estatística a descrever.
  • PROJECT_ID: o ID do projeto que contém a estatística.
  • LOCATION: a localização para listar estatísticas.

  • INSIGHT_TYPE: o tipo de informação do analisador de rede, como google.networkanalyzer.vpcnetwork.connectivityInsight.

    Para ver uma lista completa dos tipos de estatísticas, consulte o artigo Grupos e tipos de estatísticas.

API

Para obter detalhes de uma estatística, faça um pedido GET ao método projects.locations.insightTypes.insights:

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

Substitua o seguinte:

  • PROJECT_ID: o ID do projeto.
  • LOCATION: a localização da estatística.

  • INSIGHT_TYPE: o tipo de informação do analisador de rede, como google.networkanalyzer.vpcnetwork.connectivityInsight.

    Para ver uma lista completa dos tipos de estatísticas, consulte o artigo Grupos e tipos de estatísticas.

  • INSIGHT_ID: o ID da estatística.

Grupos e tipos de estatísticas

Para mais informações acerca das estatísticas do Analisador de rede, consulte o artigo Grupos e tipos de estatísticas.