.. _actions_mgmnt: **************************************** Manage |c3-short| Alert Actions for |cp| **************************************** After creating a :ref:`trigger `, you are prompted to create or select an existing action; or you can click **I'll do this later**. .. figure:: /images/c3-trigger-saved.png :scale: 50% :alt: Trigger saved modal dialog The Actions page is blank when there are no actions defined. Clicking the **Actions** tab shows a summary of all configured actions: .. figure:: /images/c3-alerts-actions-overview.png :width: 600px :alt: Alerts Action page Use the Actions page to: - Create an action using the **+ New action** button. - View and sort a summary of actions, their maximum frequency, number of associated triggers, and status. - Search for an action. - :ref:`Pause and resume ` all enabled actions. The Status column indicates whether a particular action is individually enabled, disabled, or paused. The Pause all actions toggle indicates whether all enabled actions are currently paused. - :ref:`Edit ` or :ref:`delete ` an existing action. .. _new_edit_action_form: New or edit Action form ======================= Complete the Action form to specify the type of notification you want to receive when a defined trigger has fired. Supported notification actions include: - email - PagerDuty - Slack .. email action .. figure:: /images/c3-action-email-blank.png :width: 600px :alt: Action form for email Email Action Form .. pagerduty action .. figure:: /images/c3-action-pagerduty-blank.png :width: 600px :alt: Action form for PagerDuty integration notification PagerDuty Action Form .. slack action .. figure:: /images/c3-action-slack-blank.png :width: 600px :alt: Action form for Slack webhook notification Slack Action Form Prerequisites: - Define a :ref:`trigger ` for an action. - Configure the prerequisites for each type of action. .. _action_fields_desc: Action field descriptions ------------------------- A description of each action field follows. Most fields are required, as noted by the asterisks in the UI. Action name A unique name for the action (for example: ``email DevOps on call``). .. include:: ../includes/unique-trigger-action-name.rst Enabled/Disabled You might want to temporarily disable actions. Choose whether an action is currently enabled or disabled with this field. .. tip:: Temporarily pause all enabled alerts actions when performing maintenance or troubleshooting. See :ref:`pause_resume_alerts_actions_UI`. Triggers One or more triggers that will cause the action to execute. Refer to :ref:`concepts_alerts` for more information. Action The type of action to perform: **Send email**; or webhook options **Send PagerDuty notification**, or **Send Slack notification**. Recipient email address (email action only) The email address or addresses associated with this action. A message is sent to the specified email address each time the action is executed. Separate multiple email addresses with a comma. Webhook URL (Slack webhook notification only) The URL generated in Slack. The **Generate incoming webhook URL** links to `Slack instructions `_. Slack Username (Slack webhook notification only) Optional. If configured, overrides the username configured by default when the webhook was set up in Slack. The username represents the user who sent the alert. For example: ``@username``. Slack Channel (Slack webhook notification only) Optional. If configured, overrides the channel configured by default when the webhook was set up in Slack. The channel is the destination for the notification in Slack. For example: ``#mychannel``. You can configure this field to send a notification to a Slack channel or a direct message to a Slack user. .. tip:: You can also send a direct message to a user instead of a channel by setting ``@user`` in the Channel field. PagerDuty Routing Key (PagerDuty action only) The Integration key from PagerDuty. Refer to the `PagerDuty documentation `_ to generate an integration key. Event severity (PagerDuty action only) The severity for auto-created PagerDuty events: Critical, Error, Info, or Warning. Subject The subject line of the notification associated with the action. Max send rate The maximum rate at which the action should be executed. Set in conjunction with **Frequency**. A value and frequency: Per hour (default), Per minute, Per 4 hours, Per 8 hours, Per day. For example, enter 1 and select Per day to send the alert once daily. Refer to :ref:`concepts_alerts` for more information. Per hour Choose a frequency from the pull-down menu for how often notifications should be sent. Set in conjunction with **Max send rate**. .. tip:: See :ref:`config_actions_ex` for step-by-step action examples. .. _pause_resume_alerts_actions_UI: Pause and resume all alerts actions =================================== Pause all enabled alerts when necessary for maintenance or troubleshooting reasons. The existing settings of individual actions that are enabled or disabled is respected during pause and resume. Any trigger conditions that are met and fired are ignored while paused, and all enabled actions associated with a trigger are suppressed. When ready, resume alerts again. The next time a trigger condition fires, its enabled actions send their corresponding alerts. .. warning:: If you stop and restart |cp| or |c3-short|, the paused actions resume and become active again. Click the **Pause all actions** toggle to pause the actions again. **To temporarily pause all alerts actions:** .. first nav step click bell .. include:: ../includes/alerts-bell-nav.rst #. Click the **Actions** tab. #. Click the **Pause all actions** toggle. You are prompted to confirm pausing all currently enabled actions. #. Click **Confirm**. A check mark in the toggle indicates all enabled actions are currently paused. .. figure:: /images/c3-paused-actions-toggle.png :alt: Pause all actions toggle **To resume paused alerts actions:** .. first nav step click bell .. include:: ../includes/alerts-bell-nav.rst #. Click the **Actions** tab. #. Click the **Pause all actions** toggle. You are prompted to confirm resuming all currently paused actions. #. Click **Confirm**. The **Pause all alerts** toggle is deactivated. .. _disable_enable_alert_action_UI: Disable or enable an individual alert action ============================================= When you create an action, it is enabled by default. Disable an action if you do not want it to be active. Pause and resume actions respect the disabled setting for an action. Resuming paused alerts does not activate disabled alert actions. **To disable an action:** .. first nav step click bell .. include:: ../includes/alerts-bell-nav.rst #. Click the **Actions** tab. #. In the **Name** column, click the action you want to disable. #. Click **Edit**. #. Click the **Enabled/Disabled** action toggle. .. figure:: /images/c3-alerts-action-enabled-toggle.png :width: 600px :alt: Action enabled toggle The toggle switches off and the action displays as Disabled in the Status column. #. Click **Save**. To enable an action again, repeat the procedure and click the **Enabled/Disabled** toggle again. .. _edit_alert_action: Edit an alert action ==================== .. first nav step click bell .. include:: ../includes/alerts-bell-nav.rst #. Click the **Actions** tab. #. Click the name of the action. #. Click **Edit**. #. Make the changes you want to the action fields. Note that when you are running |c3-short| in :ref:`Reduced infrastructure mode `, and you delete an incompatible trigger, it will no longer display in the Triggers drop-down. #. Click **Save**. .. _delete_alert_action: Delete an alert action ====================== .. first nav step click bell .. include:: ../includes/alerts-bell-nav.rst #. Click the **Actions** tab. #. Click the name of the action. #. Click **Delete**. #. Confirm deleting the action.