Registra los registros de acceso de Apigee

Esta página se aplica a Apigee, pero no a Apigee Hybrid.

Consulta la documentación de Apigee Edge.

Los clientes de suscripción de Apigee y de pago por uso pueden habilitar los registros de acceso de entrada de Cloud Logging para cada instancia de Apigee en su organización. Una vez habilitada, esta función te permite ver los registros generados por las puertas de enlace de entrada en tu infraestructura de Apigee, como un balanceador de cargas de aplicaciones externo o una puerta de enlace de Anthos, para ayudar a solucionar problemas de llamadas a la API de Apigee.

Es importante tener en cuenta que si esta función está habilitada para una o más de tus instancias de Apigee, se te cobrará por los registros enviados a tu proyecto. Para obtener más información sobre los cargos de Google Cloud por el registro, consulta los precios de Cloud Logging.

En este tema, se describe cómo los clientes de Apigee pueden habilitar y usar los registros de acceso de entrada de Cloud Logging para las instancias de Apigee en su organización.

Antes de comenzar

Para habilitar la función, debes tener el siguiente rol y los siguientes permisos:

• Roles: Administrador de la organización de Apigee (roles/apigee.admin)
• Permisos:
  • apigee.instances.create
  • apigee.instances.update

Habilita el registro de acceso de entrada para las instancias de Apigee

Puedes habilitar el registro de acceso de entrada de Cloud Logging cuando creas o editas una instancia de Apigee con la IU de Apigee en la consola de Cloud o la API.

Para habilitar la función cuando creas o actualizas una instancia de Apigee, sigue las instrucciones en Administra instancias para comenzar a crear o editar una instancia.

curl "http://apigee.googleapis.com/v1/organizations/ORG_NAME/instances/INSTANCE_NAME?updateMask=access_logging_config.enabled,access_logging_config.filter" \
    -X PATCH -H "Authorization: Bearer $TOKEN" \
    -H 'Accept: application/json' -H 'Content-Type: application/json' \
    -d '{ 
      "name": "INSTANCE_NAME",
      "accessLoggingConfig": 
        { 
          "enabled": "true", 
          "filter": "status_code >= 0 && status_code < 600 " 
        }
      }'

Una vez que la instancia se crea o actualiza correctamente, los registros de acceso de entrada para esa instancia deberían estar disponibles en tu proyecto en cuestión de minutos.

Visualiza los registros de acceso de entrada

Una vez habilitada la función, podrás ver los registros de acceso de entrada de las instancias de tu proyecto en cuestión de minutos mediante el Explorador de registros de la consola de Google Cloud.

Para ver las entradas de registro en el Explorador de registros, sigue estos pasos:

1. En la consola de Google Cloud, selecciona Logging > Explorador de registros.

   Ir al Explorador de registros

2. Asegúrate de que tu proyecto de Google Cloud esté seleccionado.
3. En la pestaña Consulta, ingresa el nombre de registro en el campo del Editor de consultas mediante uno de los siguientes métodos:
   • Para usar la casilla de selección Nombre del registro, sigue estos pasos:
     1. Haz clic en la casilla de selección Nombre del registro para abrir el panel Nombre del registro.
     2. Ingresa ingress_instance en el cuadro Seleccionar nombres de registro.
     3. Haz clic en Aplicar.
     4. El nombre del registro aparece en el campo del editor de consulta.
   • En el campo del Editor de consultas, ingresa el nombre de registro directamente:

     logName="projects/ORG_NAME/logs/apigee.googleapis.com/ORG_NAME"

     En el ejemplo anterior, ORG_NAME es el nombre de tu organización de Apigee.

4. Compila el resto de tu consulta en el campo del editor de consultas. Los registros aparecerán en la lista Resultados de la consulta.
5. Haz clic en cualquier entrada de registro para obtener más detalles.

Soluciona problemas con los registros de acceso de entrada

Una vez que la función habilitada y los registros estén disponibles en el Explorador de registros, puedes aprovechar una serie de funciones de Cloud Logging para solucionar problemas, incluidas las siguientes:

• Compila consultas con el lenguaje de consulta de Cloud Logging

  Para recuperar y analizar registros cuando usas el Explorador de registros, escribe consultas en el campo del editor de consultas y realiza selecciones desde las opciones de menús de filtro incluidas en las entradas de registro. Para obtener más información sobre cómo compilar consultas y analizar datos en el Explorador de registros, visita Compila y guarda consultas con el lenguaje de consulta de Cloud Logging.

• Habilita alertas y métricas basadas en registros

  Puedes definir su propia métrica basada en registros para capturar información específica de sus instancias de Apigee. Para obtener más información, consulta Descripción general de las métricas basadas en registros.

  Puedes crear una política de alertas basada en registros desde el Explorador de registros. Para obtener más información y pasos detallados, consulta Crea una política de alertas basada en registros mediante el explorador de registros.

• Filtrado por códigos de estado HTTP

  Puedes definir mejor tus consultas en el Explorador de registros para filtrar por códigos de estado HTTP, incluso si no elegiste filtrar tus registros de acceso de entrada por código de estado HTTP cuando habilitaste la función. Para agregar este filtro a tu consulta, usa el siguiente formato:

  status_code > XX && status code <= YY

  Por ejemplo:

  status_code >= 500 && status_code < 504

• Filtrado por códigos de estado de entrada

  Además de filtrar por códigos de estado HTTP, puedes crear una consulta para filtrar por ingress status_code 0. Este código a menudo indica un problema de red o conectividad que impide que el cliente reciba una respuesta del servidor.

Para obtener una explicación detallada de todas las funciones disponibles en el Explorador de registros, consulta Visualiza los registros con el Explorador de registros.

Inhabilita la función

Una vez que hayas terminado de solucionar los problemas de la instancia de Apigee, puedes editarla para inhabilitar la función. Si inhabilitas la función, se desactivará el acceso a los registros ingress_instance del proyecto y se detendrá la facturación.

Puedes editar la instancia para inhabilitar la función con la IU de Apigee en la consola de Cloud o la API.

curl "http://apigee.googleapis.com/v1/organizations/ORG_NAME/instances/INSTANCE_NAME?updateMask=access_logging_config.enabled,access_logging_config.filter" \
    -X PATCH -H "Authorization: Bearer $TOKEN" \
    -H 'Accept: application/json' -H 'Content-Type: application/json' \
    -d '{ 
      "name": "INSTANCE_NAME",
      "accessLoggingConfig": 
        { 
            "enabled": "false" 
        }
        }'