En las aplicaciones de Node.js, los complementos se mantienen para las aplicaciones Bibliotecas de registro Winston y Bunyan Winston es una biblioteca de uso general, implementando una variedad de formateadores de registros y transportes. Bunyan, que se especializa en registros JSON estructurados, admite el formateo de registros canalizando a la línea de comandos Bunyan.
También puedes usar la biblioteca cliente de Logging para directamente con Node.js crear tus propias integraciones con tu biblioteca de registros preferida. Por ejemplo, puedes usar el ejemplo del marco de trabajo del registro Pino.
No es necesario que el agente de Logging esté instalado para usar Winston o Bunyan en una instancia de máquina virtual (VM) de Compute Engine
Antes de comenzar
- Accede a tu cuenta de Google Cloud. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.
-
Enable the Cloud Logging API.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.
-
Enable the Cloud Logging API.
- Prepara el entorno para el desarrollo en Node.js.
Configura el registro
En esta sección, se describe cómo instalar y configurar los complementos para la Bibliotecas de registro Winston y Bunyan Para Bunyan, se proporciona información sobre cómo usar Bunyan con un nodo Express de Node.js y mantener la integridad de su aplicación.
Puedes usar otras bibliotecas o frameworks. Por ejemplo, puedes usar el Framework de registro de Pino. Para el código de muestra que usa OpenTelemetry para recopilar métricas y datos de seguimiento, y el framework de registro Pino para recopilar registros datos, consulta Genera seguimientos y métricas con Node.js. Si usas Pino, debes implementar una asignación entre Pino. y los que usa Cloud Logging. Para ver ejemplos de código, consulta Asigna niveles de registro Pino.
Instala y configura el complemento Winston
Cloud Logging proporciona un complemento destinado a la biblioteca Winston de Logging para Node.js. El complemento de Logging para Winston proporciona una capa más simple y de nivel superior a fin de trabajar con Logging.
Para instalar y configurar el complemento Winston, haz lo siguiente:
Para instalar el registro Para el complemento Winston, usa npm:
npm install --save @google-cloud/logging-winston winston
Importa el complemento y agrégalo a tu configuración de Winston:
Configura el complemento.
Puedes personalizar el comportamiento del complemento Winston con el mismo opciones de configuración compatibles con la biblioteca cliente de Cloud de la API de Cloud Logging para Node.js. Estas opciones se pueden pasar en el objeto
options
que se pasa al archivo .
Instala y configura el complemento Bunyan
Cloud Logging proporciona un complemento para la biblioteca de Logging de Node.js de Bunyan. El complemento de Logging para Bunyan proporciona una capa más simple y de nivel superior a fin de trabajar con Logging.
Para instalar y configurar el complemento Bunyan, haz lo siguiente:
Para instalar el registro Para el complemento Bunyan, usa npm:
npm install --save bunyan @google-cloud/logging-bunyan
Importa el complemento y agrégalo a tu configuración de Bunyan:
Configura el complemento.
Puedes personalizar el comportamiento del complemento Bunyan con las mismas opciones de configuración que admiten la biblioteca cliente de Cloud de la API de Cloud Logging para Node.js. Estas opciones se pueden pasar en el objeto
options
que se pasa al archivo .
Cómo usar Bunyan y Express
Puedes configurar y usar Bunyan con Logging en un Node.js Express y mantener la integridad de su aplicación.
Para obtener más información sobre la instalación, consulta la documentación de las bibliotecas de Cloud Logging para Node.js. También puedes informar problemas con el seguimiento de problemas.
Escribe registros con la biblioteca cliente de Cloud Logging
Si deseas obtener información sobre el uso de la biblioteca cliente de Cloud Logging para directamente sobre Node.js; consulta Bibliotecas cliente de Cloud Logging.
Ejecuta en Google Cloud
Para que una aplicación escriba registros con las bibliotecas de Cloud Logging para Node.js, la
cuenta de servicio del recurso subyacente debe tener la
Rol de IAM de Escritor de registros (roles/logging.logWriter
).
La mayoría de los entornos de Google Cloud configuran automáticamente
cuenta de servicio para tener este rol.
App Engine
Cloud Logging se habilita automáticamente para App Engine, y la API de cuenta de servicio predeterminada tiene los permisos de IAM de forma predeterminada para escribir entradas de registro.
Para escribir entradas de registro desde tu app, te recomendamos que uses Bunyan o Winston como se describe en esta página.
Para obtener más información, consulta Escribir y visualizar registros.
Google Kubernetes Engine (GKE)
GKE otorga automáticamente la cuenta de servicio predeterminada.
el rol de IAM de escritor de registros (roles/logging.logWriter
).
Si usas
Federación de identidades para cargas de trabajo para GKE
con esta cuenta de servicio predeterminada para permitir que las cargas de trabajo accedan a recursos
las APIs de Google Cloud, no se requiere ninguna configuración adicional.
Sin embargo, si usas la Federación de identidades para cargas de trabajo para GKE con una
cuenta de servicio de IAM personalizada y, luego, asegúrate de que la cuenta
tiene el rol de Escritor de registros (roles/logging.logWriter
).
Si es necesario, también puedes usar el siguiente comando para 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. Cuando crees una instancia nueva a través del
consola de Google Cloud, 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. Cualquiera que sea el servicio
que selecciones, asegúrate de que se le haya otorgado la
El rol de escritor de registros en IAM y Administrador de la
Consola de Google Cloud
Funciones de Cloud Run
Las funciones de Cloud Run otorgan el rol de escritor de registros. de forma predeterminada.
Las bibliotecas de Cloud Logging para Node.js se pueden usar sin necesidad de proporcionar credenciales de forma explícita.
Las funciones de Cloud Run están configuradas para usar Cloud Logging automáticamente.
Ejecuta de forma local y en otros lugares
Si deseas usar las bibliotecas de Cloud Logging para Node.js fuera de Google Cloud, incluida la ejecución de la biblioteca en tu propia estación de trabajo, en la infraestructura computadoras o en las instancias de VM de otro proveedor de servicios en la nube, debes suministra tu ID del proyecto de Google Cloud y cuenta de servicio las credenciales directamente en las bibliotecas de Cloud Logging para Node.js.
Para las cuentas de servicio existentes, haz lo siguiente:
Otorga la IAM a la cuenta de servicio Rol de IAM de Escritor de registros (
roles/logging.logWriter
). Para obtener más información sobre IAM, consulta Control de acceso.Configura las credenciales predeterminadas de la aplicación.
Si no tienes una cuenta de servicio, crea una. Para obtener información sobre este proceso, consulta Crea cuentas de servicio.
Si quieres obtener información general sobre los métodos que puedes usar para la autenticación, consulta Terminología: cuentas de servicio.
Usa Winston:Usa Bunyan:
Consulta los registros
En la consola de Google Cloud, ve a la página Explorador de registros.
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Logging.
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 una debate sobre la observabilidad de Google Cloud heredada y la observabilidad las soluciones de Kubernetes Monitoring y cómo esas opciones afectan la tipo de recurso, consulta Migra a Kubernetes Monitoring de Google Cloud Observability.
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.
- 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.
- Borra el contenido que aparece en el cuadro de filtro.
- Haz clic en Enviar filtro.
Puedes examinar las entradas individuales para identificar tus recursos.
Para obtener información adicional, consulta Usa el Explorador de registros.