Puede publicarse una alerta dentro de un flujo de trabajo en respuesta a un evento definido en el flujo de trabajo. La acción de alerta puede crearse en el flujo de trabajo o a través de la BUI o la CLI. La alerta debe publicarse dentro del flujo de trabajo.
Pueden utilizarse alertas personalizadas para ayudar a garantizar la conformidad o las políticas administrativas. Las alertas personalizadas también pueden ayudar a diagnosticar problemas en un flujo de trabajo.
La siguiente tabla describe las autorizaciones que debe tener un usuario para crear acciones de alerta personalizadas y publicar alertas personalizadas.
|
Para acceder a instrucciones sobre cómo otorgar autorizaciones a usuarios, consulte Configuración de usuarios.
Utilice uno de los siguientes métodos para crear una alerta personalizada:
Especifique la categoría de evento Personalizada o custom al crear una acción de alerta, como se describe en la siguiente documentación:
Agregación de una acción de alerta para un evento definido en un flujo de trabajo: BUI, CLI
Personalizar alertas de Guía de la API de RESTful de Oracle® ZFS Storage Appliance (versión OS8.8.x)
Utilice la función createalert en una secuencia de comandos o un flujo de trabajo. Para usar createalert en una secuencia de comandos, consulte Uso de las funciones de alertas personalizadas. El resto de esta sección describe cómo utilizar createalert en un flujo de trabajo.
La función createalert toma los siguientes parámetros y devuelve el UUID de la acción de alerta personalizada que se ha creado.
|
Este ejemplo muestra un flujo de trabajo que crea una alerta personalizada con el UUID custom_alert_uuid.
var workflow = { name: 'createalert', description: 'Create a Custom Alert', version: '1.0', origin: 'Oracle', alert: false, setid: true, execute: function () { var actions = [{ handler: 'email', args: { address: 'admin@example.com', subject: 'Custom Alert Response' } }]; var createparams = { description: 'createalert from within a workflow' }; var custom_alert_uuid = createalert(actions, createparams); } };
Al crear una alerta personalizada con un flujo de trabajo, la alerta aparece en la lista de acciones de alerta en la BUI y la CLI.
Al crear una alerta personalizada con un flujo de trabajo, se crea una entrada del log de auditoría con el siguiente resumen:
Workflow name_of_workflow: created custom alert value_of_custom_alert_uuid
Al crear una alerta personalizada con la BUI o la CLI, o a través de la ejecución de una secuencia de comandos (con el comando script), se crea una entrada del log de auditoría con el siguiente resumen:
Created custom alert value_of_custom_alert_uuid
Utilice la función postalert para publicar una alerta personalizada dentro de un flujo de trabajo en respuesta a un evento que se produce en ese flujo de trabajo.
La función createalert puede invocarse dentro de una secuencia de comandos a través del comando script, mientras que la función postalert solo puede invocarse dentro de una definición de flujo de trabajo.
La función postalert toma los mismos parámetros que la función createalert, salvo el primer parámetro: createalert toma una lista de controladores o acciones de alerta, y postalert toma el UUID de la alerta que se publicará. Para conocer las descripciones del resto de los parámetros, consulte Tabla 161, Parámetros de la función createalert.
Los valores de los parámetros que son opciones para createalert (severity, response, impact y action) no son opcionales para postalert. Para la llamada postalert, estos valores se determinan en función de las siguientes reglas:
Si se proporcionan valores de parámetros opcionales para createalert, pero no para la llamada postalert de ese UUID, la llamada postalert hereda esos valores de parámetros de la llamada createalert correspondiente.
Si no se proporcionan valores de parámetros opcionales para createalert, pero sí para la llamada postalert de ese UUID, la llamada postalert utiliza los valores especificados en la llamada postalert.
Si se proporcionan valores de parámetros opcionales tanto para createalert como para la llamada postalert correspondiente, cada llamada utiliza los valores de parámetros especificados en esa llamada.
Si no se proporcionan valores de parámetros opcionales para la llamada createalert ni para la llamada postalert correspondiente, un mensaje de error le indica al usuario que proporcione valores para la llamada postalert.
La función postalert devuelve el UUID de la alerta personalizada que se ha publicado.
Ejemplo 19 Creación y publicación de una alerta personalizada dentro de un flujo de trabajoEste ejemplo publica la alerta que se creó en Ejemplo 18, Creación de una alerta personalizada dentro de un flujo de trabajo. La llamada postalert se realiza en respuesta a un evento que se produjo en el flujo de trabajo. En este ejemplo, se omite el código que define el evento que ocurre antes de la llamada postalert.
var workflow = { name: 'createalert and postalert', description: 'Create and Post a Custom Alert', version: '1.0', origin: 'Oracle', alert: false, setid: true, execute: function () { var actions = [{ 'handler': 'resume_dataset', 'args': { 'dataset': 'dataset_to_resume' } }]; var createparams = { description: 'createalert and postalert from within a workflow' }; var postparams = { severity: 'Minor', description: 'postalert from within a workflow', response: 'The alert action resumes dataset dataset_to_resume', impact: 'What happened to the appliance', recommended_action: 'What the administrator should do' }; var custom_alert_uuid = createalert(actions, createparams); var posted_alert_uuid = postalert(custom_alert_uuid, postparams); } };
Al ejecutar un flujo de trabajo que invoca la función postalert, se crea una entrada de log de alerta con el siguiente resumen:
Custom: name_of_workflowEjemplo 20 Publicación de una alerta personalizada con un UUID de acción de alerta existente
En lugar de propagar copias de la misma acción de alerta, quizás le convenga utilizar el UUID de una alerta personalizada existente como primer argumento de la función postalert.
Utilice la BUI, la CLI, una secuencia de comandos, un flujo de trabajo o la API de RESTful para crear una acción de alerta personalizada.
Utilice la BUI, la CLI o el log de auditoría para recuperar el UUID de la acción de alerta personalizada.
Utilice el UUID recuperado como primer argumento de la función postalert.
var workflow = { name: 'postalert', description: 'Post a Custom Alert using existing uuid', version: '1.0', origin: 'Oracle', alert: false, setid: true, execute: function () { var postparams = { severity: 'Minor', description: 'postalert from within a workflow', response: 'What the system will do', impact: 'What happened to the appliance', recommended_action: 'What the administrator should do' }; var posted_alert_uuid = postalert('uuid_of_existing_custom_alert', postparams); } };