Registros de errores de consulta de los complementos de Google Workspace

Cuando un complemento publicado de Google Workspace devuelve un error, el de complemento devuelve un mensaje genérico "Se produjo un error al ejecutar el complemento". Sin embargo, estos errores accede al Explorador de registros de Cloud.

Nota: Para Apps Script, si tu el complemento se implementa como una prueba, luego se informan en el Explorador de registros de Cloud y en del complemento.

Por ejemplo, una implementación de prueba de complemento puede mostrar un mensaje de error como este en su interfaz: TypeError: card.INVALIDFUNCTIONNAME is not a function [line: 33, function: getContextualAddOn, file: GetContextualAddOn].

Si bien los mensajes de error como este son útiles, disponibles en el Explorador de registros. Como práctica recomendada, consulta los registros de errores para más información. Para obtener más información sobre las pruebas implementaciones de complementos, consulta Prueba y depura los complementos de Google Workspace.

En esta guía, se describe cómo consultar los registros de errores de complementos en con el Explorador de registros de Cloud, para que puedas hacer lo siguiente:

• Descubre si los usuarios encuentran errores.
• Consulta la frecuencia con la que se producen errores y los más frecuentes.
• Lee mensajes de error descriptivos que te ayudarán a corregirlos.

Requisitos previos

Antes de consultar los registros de errores del complemento, haz lo siguiente:

• Habilita la “API de Cloud Logging” en los complementos proyecto de Google Cloud. Para habilitar una API, consulta Crea un proyecto de Cloud y habilita la API.
• Publica el complemento en Google Workspace Marketplace. Para publicar un complemento en la Marketplace, consulta Publica una app.

Registros de errores del complemento de consultas

Sigue estos pasos para obtener los registros de un complemento:

1. Abre Google Cloud Console
2. Junto a "Google Cloud Platform", haz clic en la flecha hacia abajo y selecciona proyecto complementario.
3. En la esquina superior izquierda, haz clic en Menú . > Registro. Se abrirá el Explorador de registros.

4. Para los registros de errores del complemento, en el compilador de consultas, ingresa la siguiente consulta:

   severity>=ERROR
   protoPayload.serviceName="gsuiteaddons.googleapis.com"
   

5. Para ver los errores recientes, haz clic en Ejecutar consulta. O bien, para ver los errores a medida que haz clic en Transmitir registros. Los registros de errores de complementos aparecen en “Resultados de la consulta” del panel de control.

Para obtener más información sobre el Explorador de registros de Cloud y cómo escribir consultas, consulta lo siguiente:

• Usa el Explorador de registros
• Cómo crear consultas

Habilita o inhabilita el registro de errores

De forma predeterminada, el registro de errores está habilitado. Cuando el registro de errores está habilitado, archivo de manifiesto tiene lo siguiente:

"exceptionLogging": "STACKDRIVER",

Para inhabilitar el registro de errores, reemplaza "exceptionLogging": "STACKDRIVER", por la siguiente línea en la archivo de manifiesto:

// Disable error logging
"exceptionLogging": "NONE"

Para volver a habilitar el registro de errores, reemplaza "exceptionLogging": "NONE" por "exceptionLogging": "STACKDRIVER",

Consideraciones

Mientras trabajas con registros de errores de complementos en Cloud Logs Explorador, ten en cuenta estas consideraciones:

• Los complementos solo registran errores en el Explorador de registros. Otros tipos de registros no se registró.
• Los mensajes de error siempre se escriben en inglés.
• Cloud Logging genera un costo. Para obtener más información sobre Cloud Logging, consulta los precios de Google Cloud Observability.