Usa la API y la CLI del recomendador

Network Analyzer usa el recomendador con comandos de SQL sencillos. 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 la Tipos de estadísticas del recomendador

Solicita 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: Es el ID del proyecto que deseas. para enumerar las estadísticas. También puedes enumerar todas las estadísticas de una carpeta, 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: La estadística de Network Analyzer tipo que deseas 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 deben crear las estadísticas, como las siguientes: global, europe, asia-east1 o us-central1-a.
  • INSIGHT_TYPE: La estadística de Network Analyzer escribe para 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 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 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: La estadística de Network Analyzer el tipo de estadística, 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 sobre 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: La estadística de Network Analyzer el tipo de estadística, 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.