Usa la API y la CLI del recomendador

Network Analyzer usa comandos de 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 de Recommender, consulta los tipos de estadísticas de Recommender.

Solicita estadísticas

gcloud

Para enumerar estadísticas para 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 generar una lista de estadísticas. También puedes enumerar todas las estadísticas de una carpeta, una organización o una cuenta de facturación.
  • LOCATION: Es la ubicación para la que se deben crear las estadísticas, como las siguientes: global, europe, asia-east1 o us-central1-a.
  • INSIGHT_TYPE: 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 quieres 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: Es la cantidad máxima de recursos que se deben incluir en la lista. porque la cantidad predeterminada de recursos es ilimitada.

  • PAGE_SIZE: La cantidad máxima de recursos que se lista 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: una lista de elementos separados por comas nombres de claves de campo para ordenar para un recurso.

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

API

Para obtener estadísticas para 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 enumeran las estadísticas, como global, europe, asia-east1 o us-central1-a.
  • INSIGHT_TYPE: Es el tipo de estadísticas de Network Analyzer que se mostrará, 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 las estadísticas

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: El ID de la estadística que se quiere describir.
  • PROJECT_ID: El ID del proyecto que contiene la estadística
  • LOCATION: Es la ubicación para la que se deben enumerar 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: 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.