Usar a CLI e a API Recommender

gcloud

Para listar insights de um projeto 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 acessar insights de um projeto 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"
}

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.