IBM DataPower Operations Dashboard v1.0.22.x
Alerts Setup
The Setup Alerts page shows details about existing system alerts associated to the current product view, and lets you edit them and create new alerts.
Click on "Add Alert" to create a new alert.
Click on the alert name to enter the "alert details" page and edit the alert.
Column | Description |
---|---|
Name | The alert's name, click on the name to go to the Alert details Page - you can edit the alert from there. |
Description | A description of the alert - displays the "Query Value" field of the alert. |
Enabled | Shows whether or not the alert execution will be scheduled to run (this is a read only field, you can change it by editing the alert). |
System Health Metric | Shows whether or not the alert is a metric. |
Schedule | When an alert execution will be scheduled. The alert will not be scheduled if it is not enabled, even if this field contains a value |
Recipients | HTTP, Syslog (JSON Format), Syslog (Legacy Format) and/or the email addresses of the recipients for the alert publishing. |
Alert Details page
The top part displays the following fields:
Field | Description |
---|---|
Enabled | Whether or not the alert will be scheduled for execution. |
System Health Metric | Whether or not the alert is a metric. |
Description | A description of the alert -displays the value of the "Query Value" field of the alert. |
Product | Product Type |
Schedule | When an alert execution will be scheduled (if the alert is not enabled the alert will not be scheduled). |
REST URL | The URL to use in REST API to perform actions on the alert, see Alerts REST API from more details. |
Recipients | HTTP, Syslog (JSON Format), Syslog (Legacy Format) and/or the email addresses of the recipients for the alert publishing. |
The top part of the page also contains three buttons:
Test - Execute the alert immediately, the alert will be executed even if it's disabled, this is helpful in case you want to check the alert before actually scheduling it.
Edit - Edit the alert
Delete - Delete the alert
Deleted alert cannot be recovered.
If you simply do not want the alert to run - you can disable it (press "Edit" and uncheck the "Enabled" field)
The lower part of the page displays the results of the recent 20 executions of the alert
Field | Description |
---|---|
Executing User | SCHEDULER - if DPOD run an alert execution via the scheduler. REST - if the alert was run via the REST API. User name - if a user tested the alert by pressing the "Test" button. |
Status | The execution status. |
Status Time | When the status was set. |
Message | How many alerts were generated (or an error message if a problem occurred). |
Add / Edit Alert
The first section contains details about the execution of the alert
Field | Description |
---|---|
Enabled | Whether or not the alert will be scheduled for execution. |
System Health Metric | Whether or not the alert is a metric. |
Name | The Alert's name. |
Product | Gateway / API-C / Supported Products(when alert is relevant to all product views). |
Schedule | When the alert will be scheduled, the format is identical to the one used to schedule reports. |
Destination | Specify the alert publishing destinations (more information about the destinations can be found in the the Alerts page). |
Recipients | if the destination is Email or Email WS - this field will contain the list of recipients. |
The Alert Details section contains information about how the alert's query will be evaluated
Field | Description |
---|---|
Alert Type | The alert type (more information about the alert types can be found in the the Alerts page) |
Description | Free text, describes the results returned by the alert's query Press the "Details" button to view the alert query itself |
Index Sets | (Hidden by default) Which OpenSearch index sets will be queried |
Document Types | (Hidden by default) Which OpenSearch document types will be queried |
Query (JSON) | (Hidden by default) An OpenSearch query (see Query DSL and Aggregations for more information on how to build a query). |
Parameters (JSON) | (Hidden by default) Named parameters to replace placeholders in the query. i.e: |
Investigate URI | An investigate link, included in the alert results, and displays the data that triggered each alert in DPOD Web Console. |
Aggs to Ignore | Delimited list of aggregation names to ignore in results. |
Query Period | The time frame for the alert's query |
Operator | Operator for the alert's query |
Threshold | The value to compare the query's result to (not applicable for alert types "any" and "list") |
Field Name | Only applicable for alert type "List" and "Frequency" |
Value List | Only applicable for alert type "List" - the list of values delimited by the delimiter specified in the "delimiter" field |
Final results list | Only applicable for alert type "Frequency" - the list of values always returned in results, delimited by the delimiter specified in the "delimiter" field |
List Delimiter | The delimiter used to delimit the value list and the final result list |
Alert Filters Section
The Alert Filters section lets you specify additional criteria for the alert's query according to the product type and document type
Field | Field Name for REST API | Description | Applicable Product Type |
---|---|---|---|
Device | deviceName | Which DataPower devices the alert's query should check | Gateway/API-C |
Domain | domainName | Which DataPower domains the alert's query should check | Gateway/API-C |
Client IP | clientIp | Which Client IP’s the alert's query should check | Gateway/API-C |
Service | serviceName | Which DataPower services the alert's query should check | Gateway |
Catalog | apicCatalogName | Which API-C catalog names the alert's query should check | API-C |
Space | apicSpaceName | Which API-C space names the alert's query should check | API-C |
Product | apicProductName | Which API-C product names the alert's query should check | API-C |
Plan | apicPlanName | Which API-C plan names the alert's query should check | API-C |
API Name | apicApiName | Which API-C names the alert's query should check | API-C |
API Version | apicApiVersion | Which API-C versions the alert's query should check | API-C |
App Name | apicConsumerAppName | Which API-C names the alert's query should check | API-C |
Copyright © 2015 MonTier Software (2015) Ltd.