Usar la CLI y la API de Recommender

Analizador de red usa comandos de Recommender. Recommender es un Google Cloud servicio que proporciona recomendaciones de uso para Google Cloud productos y servicios. Para ver una lista completa de los tipos de estadísticas de Recommender, consulta los tipos de estadísticas de Recommender.

Solicitar estadísticas

gcloud

Para ver las estadísticas de un Google Cloud proyecto, ejecuta el siguiente 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

Haz los cambios siguientes:

  • PROJECT_ID: el ID del proyecto del que quieres obtener estadísticas. También puedes consultar todas las estadísticas de una carpeta, una organización o una cuenta de facturación.
  • LOCATION: la ubicación de la que se deben mostrar las estadísticas, como global, europe, asia-east1 o us-central1-a.
  • INSIGHT_TYPE: el tipo de métrica de Network Analyzer que se va a solicitar, como google.networkanalyzer.vpcnetwork.connectivityInsight.

    Para ver una lista completa de los tipos de estadísticas, consulta Grupos y tipos de estadísticas.

Los siguientes campos son opcionales:

  • EXPRESSION: aplica este filtro booleano a cada recurso que quieras incluir en la lista.

    Si la expresión se evalúa como True, se muestra ese elemento. Para obtener más información y ejemplos de expresiones de filtro, ejecuta $ gcloud topic filters o consulta la documentación de gcloud topic filters.

  • LIMIT: número máximo de recursos que se van a enumerar. El número predeterminado de recursos que se enumeran es ilimitado.

  • PAGE_SIZE: número máximo de recursos que se van a mostrar por página.

    El tamaño de página predeterminado lo determina el servicio. De lo contrario, no hay paginación. La paginación se puede aplicar antes o después de FILTER y LIMIT.

  • SORT_BY: lista de nombres de claves de campos separados por comas por los que se debe ordenar un recurso.

    El orden predeterminado es ascendente. Para especificar un orden descendente, añade el prefijo ~ (una tilde) a un campo.

API

Para obtener estadísticas de un proyecto Google Cloud , haz una solicitud GET al método projects.locations.insightTypes.insights:

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

Haz los cambios siguientes:

  • PROJECT_ID: el ID del proyecto.
  • LOCATION: la ubicación de la que se deben mostrar las estadísticas, como global, europe, asia-east1 o us-central1-a.
  • INSIGHT_TYPE: el tipo de información valiosa de Network Analyzer que se va a enumerar, como google.networkanalyzer.vpcnetwork.connectivityInsight.

    Para ver una lista completa de los tipos de estadísticas, consulta Grupos y tipos de estadísticas.

En el siguiente ejemplo se muestra una respuesta de muestra 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"
}

Describe los detalles de la estadística

gcloud

Para ver los detalles de una estadística concreta, ejecuta el siguiente comando:

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

Haz los cambios siguientes:

  • INSIGHT_ID: el ID de la estadística que se va a describir.
  • PROJECT_ID: el ID del proyecto que contiene la estadística.
  • LOCATION: la ubicación de la que se deben mostrar las estadísticas.
  • INSIGHT_TYPE: el tipo de métrica de Network Analyzer, como google.networkanalyzer.vpcnetwork.connectivityInsight.

    Para ver una lista completa de los tipos de estadísticas, consulta Grupos y tipos de estadísticas.

API

Para obtener detalles de una estadística, haz una solicitud GET al método projects.locations.insightTypes.insights:

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

Haz los cambios siguientes:

  • PROJECT_ID: el ID del proyecto.
  • LOCATION: la ubicación de la estadística.
  • INSIGHT_TYPE: el tipo de métrica de Network Analyzer, como google.networkanalyzer.vpcnetwork.connectivityInsight.

    Para ver una lista completa de los tipos de estadísticas, consulta Grupos y tipos de estadísticas.

  • INSIGHT_ID: el ID de la estadística.

Grupos y tipos de estadísticas

Para obtener más información sobre las estadísticas de Analizador de redes, consulta Grupos y tipos de estadísticas.