Configura Cloud Logging para PHP

Puedes escribir registros en Cloud Logging desde aplicaciones de PHP directamente con la biblioteca de Cloud Logging para PHP.

Antes de comenzar

  1. Accede a tu Cuenta de Google.

    Si todavía no tienes una cuenta, regístrate para obtener una nueva.

  2. En la página del selector de proyectos de Google Cloud Console, selecciona o crea un proyecto de Google Cloud.

    Ir a la página del selector de proyectos

  3. Asegúrate de que la facturación esté habilitada para tu proyecto de Cloud. Descubre cómo confirmar que tienes habilitada la facturación en un proyecto.

  4. Habilita las Cloud Logging API.

    Habilita la API

Instala la biblioteca de Cloud Logging para PHP

La biblioteca de Cloud Logging para PHP proporciona una implementación de registrador PSR-3 simple para los frameworks web de PHP.

A fin de escribir registros desde tu app, agrega la biblioteca de Cloud Logging para PHP a tu composer.json:

composer require google/cloud-logging

Crea un registrador PSR-3

Usa el siguiente código para crear un registrador PSR-3:

$logging = new LoggingClient([
    'projectId' => $projectId
]);
$logger = $logging->psrLogger('app');

Habilita la opción de agrupación por lotes

El registrador PSR-3 envía los registros de forma sincronizada. Esto significa que cuando emitas un registro, agregará latencia de RPC a la solicitud del usuario. En particular, si emites varios registros en una única solicitud, la latencia agregada será significativa. Es probable que quieras evitar eso.

El siguiente código crea un registrador PSR-3 que agrupará por lotes a varios registros en una sola llamada RCP:

$logger = LoggingClient::psrBatchLogger('app');

De forma predeterminada, este registrador agrupa a los registros dentro de un solo proceso. En el entorno flexible de App Engine, puedes configurar la biblioteca de Cloud Logging para PHP con una capacidad de procesamiento aún mayor y una latencia más baja. Para obtener más información, consulta Configura el daemon de registro.

Configura la biblioteca de Cloud Logging para PHP

Puedes personalizar el comportamiento de la biblioteca de Cloud Logging para PHP. Consulta el documento de configuración para obtener una lista de las opciones de configuración posibles.

Usa el registrador PSR-3

Una vez que el registrador se crea, puedes usarlo en tu aplicación:

$logger->info('Hello World');
$logger->error('Oh no');

Para obtener más información sobre la instalación, consulta la documentación de la biblioteca de Cloud Logging para PHP. También puedes informar problemas con la Herramienta de seguimiento de errores.

Usa la biblioteca cliente de Cloud directamente

Para obtener información sobre cómo usar directamente la biblioteca cliente de Cloud Logging para PHP, consulta Bibliotecas cliente de Cloud Logging.

Ejecuta en Google Cloud

Usar la biblioteca de Cloud Logging para PHP requiere la función de escritor de registros de IAM en Google Cloud. La mayoría de los entornos de Google Cloud proporcionan esta función de forma predeterminada.

App Engine

App Engine otorga la función de escritor de registros de forma predeterminada.

La biblioteca de Cloud Logging para PHP se puede usar sin necesidad de proporcionar credenciales de forma explícita.

Cloud Logging se habilita automáticamente para las aplicaciones de App Engine. No se requiere ninguna configuración adicional.

Sin embargo, te recomendamos que uses el registrador PSR-3 que agrega a tus registros metadatos de forma automática para que los registros de tu aplicación estén correlacionados con los registros de solicitud.

Configura el daemon para el entorno flexible de App Engine

En el entorno flexible de App Engine, puedes configurar la biblioteca de Cloud Logging para PHP de modo que use un programa daemon externo y así maximizar la capacidad de procesamiento de registro y minimizar la latencia de la app. Para habilitar esta función, agrega la siguiente línea a la sección runtime_config en app.yaml:

enable_stackdriver_integration: true

Google Kubernetes Engine

En Google Kubernetes Engine, debes agregar el permiso de acceso logging.write cuando creas el clúster:

gcloud container clusters create example-cluster-name --scopes https://www.googleapis.com/auth/logging.write

Compute Engine

Cuando uses las instancias de VM de Compute Engine, agrega el permiso de acceso cloud-platform a cada instancia. Si creas una instancia nueva a través de Google Cloud Console, puedes hacerlo en la sección Identidad y acceso a la API del panel Crear Instancia. Usa la cuenta de servicio predeterminada de Compute Engine o una cuenta de servicio diferente y selecciona Permitir acceso total a las API de Cloud en la sección Identidad y acceso a la API. Asegúrate de que la cuenta de servicio que selecciones tenga la función de escritor de registros en la sección IAM y administración de Cloud Console.

Ejecuta de forma local y en otros lugares

A fin de usar la biblioteca de Cloud Logging para PHP fuera de Google Cloud, incluso si la ejecutas en tu propia estación de trabajo, en las computadoras del centro de datos o en las instancias de VM de otro proveedor de servicios en la nube, debes proporcionar tu ID del proyecto de Google Cloud y las credenciales adecuadas de la cuenta de servicio directamente a la biblioteca de Cloud Logging para PHP.

Puedes crear y obtener credenciales de cuentas de servicio de forma manual. Cuando especifiques el campo Función, usa la función escritor de registros. Para obtener más información sobre las funciones de la administración de identidades y accesos, consulta la Guía de control de acceso.

Ve los registros

Después de la implementación, puedes ver los registros en el visor de registros.

Ve al Explorador de registros.

En el Explorador de registros, debes especificar uno o más recursos, aunque la selección de recursos puede no ser obvia. Aquí encontrarás algunas sugerencias que te ayudarán a comenzar:

  • Si implementas tu aplicación en App Engine o utilizas las bibliotecas específicas de App Engine, configura tu recurso como Aplicación de GAE.

  • Si implementas tu aplicación en Compute Engine, configura el recurso como Instancia de VM de GCE.

  • Si implementas tu aplicación en Google Kubernetes Engine, la configuración de registro de tu clúster determina el tipo de recurso de las entradas de registro. Para obtener información detallada sobre Google Cloud's operations suite heredado, las soluciones de Kubernetes Monitoring de Google Cloud's operations suite, y cómo estas dos opciones afectan el tipo de recurso, consulta Migra a Kubernetes Monitoring de Google Cloud's operations suite.

  • Si la aplicación usa la API de Cloud Logging directamente, el recurso depende de la API y de tu configuración. Por ejemplo, en la aplicación, puedes especificar un recurso o usar un recurso predeterminado.

  • Si no ves ningún registro en el Explorador de registros, cambia al modo de consulta avanzada y usa una consulta vacía para ver todas las entradas de registro.

    1. Para cambiar al modo de consulta avanzada, haz clic en menú (▾) en la parte superior del visor de registros y selecciona Convertir a filtro avanzado.
    2. Borra el contenido que aparece en el cuadro de filtro.
    3. Haz clic en Enviar filtro.

    Puedes examinar las entradas individuales para identificar tus recursos.

Para obtener más información, consulta Visualiza los registros y Consultas de registros avanzadas.