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:
-
En la navegación izquierda, pulse el icono Explorar registros
> Registros.
-
En la vista Registros, pulse el icono
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.
-
Pulse Gestionar acciones.
-
Pulse Añadir nueva acción.
-
Para Acción sin título, especifique un nombre para la acción.
-
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 admitenhttp://yhttps://.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. -
Seleccione el tipo de datos asociado a la acción. La acción se visualiza en el contexto seleccionado.
-
Pulse Avanzado para acceder a los valores opcionales.
-
Para que la acción sea pública, conmute Hacer público cuando se guarde.
-
Para limitar la acción a Aplicaciones o Subsistemas específicos, seleccione los valores de la lista.
-
Pulse Guardar acción
Edición de una acción
Para editar una acción existente:
-
En la navegación izquierda, pulse el icono Explorar registros
> Registros.
-
En la vista Registros, pulse el icono
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.
-
En la lista de acciones, pulse la acción que desea cambiar.
-
Efectúe los cambios.
-
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.
-
En la navegación de la izquierda, pulse el icono Explorar registros
> Registros
-
En la vista Registros, pulse el icono
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.
-
En la lista de acciones, pase el cursor por encima de la acción que desea clonar.
-
Pulse el icono Clonar. Se crea un duplicado de la acción.
-
Edite la acción clonada y realice los cambios.
-
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.
-
En la navegación izquierda, pulse el icono Explorar registros
> Registros.
-
En la vista Registros, pulse el icono
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.
-
En la lista de acciones, haga clic en la acción que desee configurar.
-
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:
-
En la navegación izquierda, pulse el icono Explorar registros
> Registros.
-
Pulse los datos visualizados en la vista. Se visualiza un menú.
-
Pase el cursor por encima de las acciones. Aparece la lista de acciones disponibles.
-
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
-
En la navegación izquierda, pulse el icono Explorar registros
> Registros.
-
En la vista Registros, pulse el icono
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.
-
En la lista de acciones, pulse la acción que desea suprimir.
-
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.applicationNameo$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}}