Usa la CLI y la API de Recommender

Network Analyzer usa comandos del recomendador. Para obtener una lista completa de los tipos de estadísticas del recomendador, consulta sus tipos de estadísticas.

Estadísticas de las solicitudes

gcloud

Para incluir en una lista las estadísticas de un proyecto de Google Cloud , ejecuta el comando que se indica a continuación:

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 los parámetros siguientes:

  • PROJECT_ID: Es el ID del proyecto cuyas estadísticas quieres agregar a una lista. También puedes agregar a una lista todas las estadísticas de una carpeta, organización o cuenta de facturación.
  • LOCATION: Es la ubicación en la que se deben agregar las estadísticas a una lista, como global, europe, asia-east1 o us-central1-a.

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

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

Los campos siguientes 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, ese elemento se incluirá 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: Es la cantidad máxima de recursos que se van a incluir en la lista; la cantidad predeterminada de recursos que se incluyen en la lista es ilimitada.

  • PAGE_SIZE: Es la cantidad máxima de recursos que se deben incluir en la lista por página.

    El servicio determina el tamaño predeterminado de la página; de lo contrario, no se realizará la 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 campos separados por comas que se ordenarán para un recurso.

    El pedido 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 los parámetros siguientes:

  • PROJECT_ID: Es el ID del proyecto.
  • LOCATION: Es la ubicación en la que se deben agregar las estadísticas a una lista, como global, europe, asia-east1 o us-central1-a.

  • INSIGHT_TYPE: Es el tipo de estadísticas de Network Analyzer que se incluirán en la lista, 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 ejemplo siguiente, 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 incluir en una lista los detalles de una estadística en particular, ejecuta el comando que se indica a continuación:

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

Reemplaza los parámetros siguientes:

  • INSIGHT_ID: Es el ID de la estadística que se va a describir.
  • PROJECT_ID: Es el ID del proyecto que contiene las estadísticas.
  • LOCATION: Es la ubicación en la que se van a incluir las estadísticas en la lista.

  • 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 siguiendo loa pasos que se indican a continuación:

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

Reemplaza los parámetros siguientes:

  • PROJECT_ID: Es 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.

Grupos y tipos de estadísticas

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