Usa la CLI y la API del recomendador

Network Analyzer usa los comandos del Recomendador. El recomendador es un servicio de Google Cloud que proporciona recomendaciones de uso para los productos y servicios de Google Cloud. Para obtener una lista completa de los tipos de estadísticas del recomendador, consulta los tipos de estadísticas del recomendador.

Solicitar estadísticas

gcloud

Para enumerar las estadísticas de un proyecto de Google Cloud, 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

Reemplaza lo siguiente:

  • PROJECT_ID: El ID del proyecto para el que deseas enumerar estadísticas. También puedes enumerar todas las estadísticas de una carpeta, organización o cuenta de facturación.
  • LOCATION: Es la ubicación para la que se mostrarán estadísticas, como global, europe, asia-east1 o us-central1-a.

  • INSIGHT_TYPE: Es el tipo de estadística de Network Analyzer que se solicitará, como google.networkanalyzer.vpcnetwork.connectivityInsight.

    Para obtener 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 desees enumerar.

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

  • LIMIT: La cantidad máxima de recursos que se enumerarán; la cantidad predeterminada de recursos enumerados es ilimitada.

  • PAGE_SIZE: Es la cantidad máxima de recursos que se mostrarán por página.

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

  • SORT_BY: Es una lista de nombres de claves de campo separados por comas para ordenar en un recurso.

    El orden predeterminado es ascendente. Para especificar un orden descendente, prefija un campo con ~ (una tilde).

API

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

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

Reemplaza lo siguiente:

  • PROJECT_ID: El ID del proyecto.
  • LOCATION: Es la ubicación para la que se mostrarán estadísticas, como global, europe, asia-east1 o us-central1-a.

  • INSIGHT_TYPE: Es el tipo de estadística de Network Analyzer que se enumerará, como google.networkanalyzer.vpcnetwork.connectivityInsight.

    Para obtener 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 enumerar los detalles de una estadística en particular, ejecuta el siguiente comando:

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

Reemplaza lo siguiente:

  • INSIGHT_ID: Es el ID de la estadística que se describirá.
  • PROJECT_ID: El ID del proyecto que contiene la estadística
  • LOCATION: Es la ubicación para la que se mostrarán las estadísticas.

  • INSIGHT_TYPE: Es el tipo de estadística de Network Analyzer, como google.networkanalyzer.vpcnetwork.connectivityInsight.

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

API

Para obtener detalles de una estadística, realiza 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

Reemplaza lo siguiente:

  • PROJECT_ID: El ID del proyecto.
  • LOCATION: Es la ubicación de la estadística.

  • INSIGHT_TYPE: Es el tipo de estadística de Network Analyzer, como google.networkanalyzer.vpcnetwork.connectivityInsight.

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

  • INSIGHT_ID: Es el ID de la estadística.

Tipos y grupos de estadísticas

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