Use a API e a CLI do Recommender

O analisador de rede usa comandos do Recommender. O Recommender é um Google Cloud serviço que fornece recomendações de utilização para Google Cloud produtos e serviços. Para 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 a qual quer apresentar 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 ver mais detalhes e exemplos de expressões de filtro, execute $ gcloud topic filters ou consulte a gcloud topic filters documentação.

  • 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 obter 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 a qual quer apresentar 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 sobre as estatísticas do Analisador de rede, consulte o artigo Grupos e tipos de estatísticas.