Opciones del plugin

• Acción (--Action '<create/close>'): Con la opción “create”, el plugin crea o actualiza tickets. La opción “close” es para cerrarlos.

• Activo (--Asset '<cmdb_asset>'): el nombre del activo que se usará en la incidencia. Si no se encuentra el activo, se utilizará uno genérico.

• Agente (--Agent '<pandora_agent_name>'): El nombre del agente de Pandora que ha generado la alerta.

• Módulo (--Module '<pandora_module_name>'): El nombre del módulo que ha generado la alerta.

• ID del módulo (--IdModule '<pandora_module_id>'): La ID numérica del módulo que ha generado la incidencia.

• URL de Service Now (--Host '<login_url>'): URL base de Service Now.

• URL de la integración con incidencias de SN (--HostAPIUrl <sn_integration_url>): URL de la integración con incidencias de Service Now (por ejemplo /api/customer/incident_integration/ )

• Tipo de autenticación (--Auth '<basic/oauth>'): En esta integración se ha usado “basic”, pero se incluye OAuth como opción.

• Usuario de SN (--User '<sn_user>'): Usuario de acceso a Service Now.

• Contraseña de SN (--Pass '<sn_pass>'): Contraseña de acceso a SN del usuario indicado en --User.

• URL de Proxy (--ProxyUrl ‘<proxy_url>’): URL de acceso al proxy. Opcional.

• Usuario de Proxy (--ProxyUser ‘<proxy_user>’): Usuario de acceso al proxy. Opcional.

• Contraseña de Proxy (--ProxyPass ‘<proxy_pwd>’): Contraseña de acceso al proxy del usuario indicado en --ProxyUser. Opcional.

• URL de la API de Pandora (--PandoraAPI '<pandora_api_url>'): URL de acceso a la API de Pandora FMS (ej. https://pandoraserver/pandora_console/include/api.php ).

• Contraseña de la API de Pandora (--PandoraAPIPass '<pandora_apipass>').

• Usuario de acceso a Pandora (--PandoraUser '<pandora_user>'): Usuario de acceso a Pandora FMS. Como mínimo debe tener permiso AW.

• Contraseña de acceso a Pandora (--PandoraPass '<pandora_pass>'): Contraseña del usuario indicado en el token --PandoraUser.

• Grupo de asignación (--Group '<ticket_assignment_group>'): Grupo de Service Now al que se asignará la incidencia creada.

• Impacto (--Impact '<ticket_impact>'): Prioridad de la incidencia creada en Service Now.

• Título (--Title '<ticket_short_description>'): Título de la incidencia en Service Now. Sólo es necesario para la apertura de incidencias.

• Descripción (--Message '<ticket_description>'): Descripción de la incidencia en Service Now.

• Estado de la incidencia (--State  '<ticket_state>'): Código numérico del estado de la incidencia. Sólo es necesario para el cierre de incidencias.

• Archivo de log (--Log '<log_file>'): Ruta completa al archivo de log en el que volcar los datos de ejecución del plugin. Opcional.

Ejemplo completo de llamada manual para apertura (o actualización) de incidencias:

pandora_sn_ticket.64 --Action 'create' --Auth 'basic' --Host 'https://my-service-now.com:1234' –-HostAPIUrl '/api/customer/incident_integration/' --PandoraAPI 'http://192.168.1.1/pandora_console/include/api.php' --User 'sn-user' --Pass 'sn-pass' --PandoraUser 'pandora_user' --PandoraPass 'pandora_pass' --PandoraAPIPass 'pandora_apipass' --Asset 'MYSERVER' --Agent 'MYSERVER' --Module 'CPU Load' --IdModule '12345' --Group 'infrastructure' --Impact '1' --Title 'Host MYSERVER is overloaded' --Message '2024/10/22 09:16:53 - Host MYSERVER CPU usage is too high - Data: 97% - Module status: critical' --Log '/tmp/pandora_sn.log'

Ejemplo completo de llamada manual para cierre de incidencias:

/pandora/pandora_sn_ticket.64 --Auth 'basic' --Host 'https://my-service-now.com:1234' –-HostAPIUrl '/api/customer/incident_integration/' --PandoraAPI 'http://192.168.1.1/pandora_console/include/api.php' --User 'sn-user' --Pass 'sn-pass' --PandoraUser 'pandora_user' --PandoraPass 'pandora_pass' --PandoraAPIPass 'pandora_apipass' --Module 'CPU Load' --IdModule '12345' --Message '2024/10/22 14:04:17 - Host MYSERVER CPU usage is OK now - Data: 24% - Module status: normal' --State '1' [--Log '/tmp/pandora_sn.log']

Ejemplos de alertas

A continuación se muestra un par de ejemplos de configuración de alertas: apertura y cierre de las incidencias, que estarán separados en dos comandos y dos acciones diferentes.

Con el fin de hacer la integración más flexible, se recomienda utilizar macros en los campos de los comandos que necesiten información dinámica. En este caso se utilizan las macros para alias de agente, módulo e ID de módulo (_agent_, _module_, _id_module_), así como macros específicas de alerta (_fieldx_) para facilitar la personalización de las acciones.

Creación / actualización de incidencias (prioridad alta)

Comando

Ejemplo de comando de alerta para crear incidencias

Acción

Ejemplo de acción de alerta para crear incidencias

Cierre de incidencias

Comando

Ejemplo de comando de alerta para cerrar incidencias

Acción

Ejemplo de acción de alerta para cerrar incidencias