Utilización de acciones en IBM Cloud Logs para integrarse con servicios de terceros

En IBM Cloud Logs, puede activar servicios de terceros en función de sus resultados y valores de búsqueda y enviar datos a esos servicios. Puede crear acciones de gestión a partir de vistas y cuadros de mando.

Creación de una acción

Para crear una acción:

  1. En la navegación izquierda, pulse el icono Explorar registros icono Explorar registros > Registros.

  2. En la vista Registros, pulse el icono Configuración Configuración. Este icono de valores no es el mismo que el icono de la navegación izquierda. El icono de valores se puede encontrar en la vista de registros en la parte superior derecha de la página.

  3. Pulse Gestionar acciones.

  4. Pulse Añadir nueva acción.

  5. Para Acción sin título, especifique un nombre para la acción.

  6. En URL TEMPLATE, introduzca la dirección URL para el servicio externo. Por ejemplo, https://test-my-url.com?type={{ $m.subsystemName === "frontend" ? "Front" : "Back" }}. Sólo se admiten http:// y https://.

    La sintaxis de JavaScript está soportada. Por ejemplo, puede especificar condiciones como {{ condition ? "true value" : "false value" }}. La mayoría de las funciones de JavaScript están soportadas.

    Puede incluir variables para pasar datos en URL. Si escribe llaves dobles ({{}}), se muestra una lista de variables disponibles.

  7. Seleccione el tipo de datos asociado a la acción. La acción se visualiza en el contexto seleccionado.

  8. Pulse Avanzado para acceder a los valores opcionales.

  9. Para que la acción sea pública, conmute Hacer público cuando se guarde.

  10. Para limitar la acción a Aplicaciones o Subsistemas específicos, seleccione los valores de la lista.

  11. Pulse Guardar acción

Edición de una acción

Para editar una acción existente:

  1. En la navegación izquierda, pulse el icono Explorar registros icono Explorar registros > Registros.

  2. En la vista Registros, pulse el icono Configuración Configuración. Este icono de valores no es el mismo que el icono de la navegación izquierda. El icono de valores se puede encontrar en la vista de registros en la parte superior derecha de la página.

  3. En la lista de acciones, pulse la acción que desea cambiar.

  4. Efectúe los cambios.

  5. Pulse Guardar acción para guardar los cambios o Restablecer para revertir la acción a la última versión guardada de la acción.

Clonación de una acción

Si desea crear una acción nueva basada en una acción existente, puede clonar una acción.

  1. En la navegación de la izquierda, pulse el icono Explorar registros icono Explorar registros > Registros

  2. En la vista Registros, pulse el icono Configuración Configuración. Este icono de valores no es el mismo que el icono de la navegación izquierda. El icono de valores se puede encontrar en la vista de registros en la parte superior derecha de la página.

  3. En la lista de acciones, pase el cursor por encima de la acción que desea clonar.

  4. Pulse el icono Clonar. Se crea un duplicado de la acción.

  5. Edite la acción clonada y realice los cambios.

  6. Haga clic en Guardar acción para guardar los cambios.

Visualización y ocultación de acciones en el menú de acciones

Puede configurar si los usuarios pueden desencadenar acciones.

  1. En la navegación izquierda, pulse el icono Explorar registros icono Explorar registros > Registros.

  2. En la vista Registros, pulse el icono Configuración Configuración. Este icono de valores no es el mismo que el icono de la navegación izquierda. El icono de valores se puede encontrar en la vista de registros en la parte superior derecha de la página.

  3. En la lista de acciones, haga clic en la acción que desee configurar.

  4. Pulse el icono Ocultar del menú de acciones para que no se incluya la acción para los usuarios en el menú de acciones. Pulse el icono Mostrar en menú de acciones para que la acción se incluya en el menú de acciones.

Desencadenamiento de una acción

Desencadene una acción realizando los pasos siguientes:

  1. En la navegación izquierda, pulse el icono Explorar registros icono Explorar registros > Registros.

  2. Pulse los datos visualizados en la vista. Se visualiza un menú.

  3. Pase el cursor por encima de las acciones. Aparece la lista de acciones disponibles.

  4. Pulse la acción para desencadenar la acción.

    Sólo las acciones configuradas para mostrarse en el menú de acciones se listan en el menú de acciones.

Supresión de una acción

  1. En la navegación izquierda, pulse el icono Explorar registros icono Explorar registros > Registros.

  2. En la vista Registros, pulse el icono Configuración Configuración. Este icono de valores no es el mismo que el icono de la navegación izquierda. El icono de valores se puede encontrar en la vista de registros en la parte superior derecha de la página.

  3. En la lista de acciones, pulse la acción que desea suprimir.

  4. Pulse Suprimir.

    La supresión se realiza inmediatamente. No se le solicitará que confirme que desea suprimir la acción.

Variables que se pueden incluir en una acción

Puede especificar variables en una plantilla URL para pasar información a su servicio externo.

Se admiten las siguientes variables:

$m.<metadata>
Las variables de metadatos están disponibles en los registros. Por ejemplo, $m.applicationName o $m.timestamp.
$d.<key>.<subkey>
Datos disponibles en el registro. Por ejemplo, $d.kubernetes.labels.my_label.
$p.start_time
El inicio del intervalo de tiempo seleccionado como marca de tiempo de época Unix, en milisegundos.
$p.end_time
El final del intervalo de tiempo seleccionado como marca de tiempo de época Unix, en milisegundos.
$p.selected_value
El valor seleccionado por el usuario en la interfaz de usuario. Si se activa pulsando una clave, se incluye todo el valor de la clave.

Acción de ejemplo

La siguiente acción genera un problema de Jira.

http://<company_name>.atlassian.net//secure/CreateIssueDetails!init.jspa?pid=<Jira_PID>&issuetype=<Jira_issueType>&description={{$d.logRecord.body}}&summary={{$d.msg}}