All Products
Search
Document Center

Application Real-Time Monitoring Service:Integrate Zabbix with ARMS

Last Updated:Apr 08, 2024

This topic describes how to integrate Zabbix with the alert management module of Application Real-Time Monitoring Service (ARMS).

Prerequisites

Only Zabbix version 5.x is supported.

Step 1: Create a Zabbix integration

  1. Log on to the ARMS console. In the left-side navigation pane, choose Alert Management > Integrations.
  2. On the Alert Integration tab, click Zabbix.

  3. In the Create Zabbix Integration dialog box, enter a name and a description for the integration, specify the automatic recovery time of alert events, and then click Save.

    Note If an alert event is not triggered again within the specified period of time, the alert event is automatically cleared.
  4. On the Alert Integration tab, find the Zabbix integration that you created and copy the URL in the Integration Address column.

    The URL of the Zabbix integration

Step 2: Configure Zabbix

  1. Log on to the server where Zabbix is deployed and run the following command to find the path of the Zabbix script:

    cat /etc/zabbix/zabbix_server.conf | grep alert

    Sample response:

    The path of the Zabbix script

  2. Run the cd command to go to the directory of the Zabbix script.

  3. Run the following command to download the installation package of the alert management module of ARMS:

    wget http://arms-public.oss-cn-shanghai.aliyuncs.com/alerts/aliyunalertmanager.tgz
  4. Run the following command to decompress the installation package:

    tar -xzvf aliyunalertmanager.tgz
  5. Go to the bin directory:

    cd aliyunalertmanager/bin
  6. Run the following command to install the alert management module:

    sh install.sh {URL of the Zabbix integration}

    In the preceding command, replace {URL of the Zabbix integration} with the URL that you obtained in Step 1.

  7. During the installation, enter the login URL of Zabbix, the administrator username, and the administrator password as prompted.

(Optional) Step 3: Modify the integration

Alert Management provides field mappings between Zabbix alert sources and ARMS alert events. You can also add or modify the mappings between fields on the Edit Integration page.

Sample alert source:

{
    "startat":"2021.09.09 20:13:57",
    "eventId":"16874-9756",
    "eventType":"trigger",
    "message":"/: Used space in Zabbix server value is 81 GB, triggered an alarm disk usage trigger",
    "hostname":"Zabbix server",
    "ip":"127.0.0.1",
    "severity":"Warning",
    "value":"81 GB",
    "metric":"vfs.fs.size[/,used]",
    "itemName":"/: Used space",
    "alertname":"disk usage trigger",
    "eventUrl":"http://127.0.0.1/zabbix/tr_events.php?triggerid=16874&eventid=9756"
}
  1. On the Alert Integration tab, find the integration that you want to manage and click Edit in the Actions column.
  2. In the Event Mapping section, click Send Test Data.
  3. In the Send Test Data dialog box, enter the alert content of a third-party alert source in the JSON format and click Send.
    Note
    • If the message Uploaded. No events are generated. Configure mappings based on the original data. appears, the fields of the alert source are not mapped to the fields of ARMS alert events. The data that is sent is displayed in the left-side box. This allows you to select the source fields when you configure mappings.
    • If the message Uploaded. appears, the alert content is reported to the Alert Event History page. For more information, see View historical alert events.
  4. In the Send Test Data dialog box, click Disable.
  5. In the left part of the Event Mapping section, click the data records for which you want to configure mappings to view the details.
  6. In the right part of the Event Mapping section, configure field mappings between the alert source and ARMS.

    1. Optional:In the Select Root Node section, specify whether to enable batch processing.
      If an array node exists in the alert data, you can specify the array node as the root node. The data that belongs to the root node is processed in batches.

      After you select Use Batch Processing, select the array node to be batch processed as the root node.

      Note If multiple array nodes exist in the alert data, you can select only one of the array nodes for batch processing.
    2. In the Map Source Fields to Target Fields section, map the fields of the alert source to the alert fields of ARMS.
      Click the mapping icon to change the method for field mapping.
      • Direct: The specified field of the alert source is directly mapped to the specified alert field of ARMS.
      • Series: You can use delimiters to concatenate multiple fields of the alert source into one field, and then map this field to the specified alert field of ARMS. Only special characters can be used as delimiters.
      • Conditional: The specified alert source fields are mapped to the ARMS alert fields only when the field values meet the specified conditions.
      • Mapping table: The alert source severity is mapped to the ARMS alert severity. The mapping table contains only the severity field.

      The following table describes the alert fields of ARMS.

      Alert fieldDescription
      alertnameThe name of the custom alert.
      severityThe severity level of the alert. You must configure mappings for this field. The mapping method must be set to Direct.
      messageThe description of the alert. The description is used as the content of the alert message. The description cannot exceed 15,000 characters in length.
      valueThe sample value of a metric.
      imageUrlThe URL of the line chart that contains Grafana metrics. The URL is used to map the line chart.
      checkThe check item of the alert. Examples: CPU, JVM, Application Crash, and Deployment.
      sourceThe source of the alert.
      classThe type of the object that triggers the alert event, for example, host.
      serviceThe source service of the alert. Example: Login Service.
      startatThe timestamp that represents the start time of the event.
      endatThe timestamp that represents the end time of the event.
      generatorUrlThe URL of the event details.
  7. Configure field deduplication for alert events.
    To reduce duplicate data, the system uses relevant fields as the basis for deduplication. ARMS Alert Management allows you to preview the deduplication grouping results of historical event data that is displayed in the Event Mapping section. You can change the fields to be deduplicated.
    Note You can configure deduplication only for events that are not cleared.
    1. In the Event Deduplication section on the Integration Details page, select the fields that are used for deduplication.
      If multiple events have the same value for a specified field, the events are merged into one alert notification.
    2. Click Deduplication Test to preview the alert group after deduplication.
      Note The deduplication test takes effect only on the latest 10 data records that are uploaded in the left part of the Event Mapping section.
  8. After you configure the settings, click Save.

Verify the result

After you install the alert management module of ARMS in Zabbix, ARMS creates a user, user group, media type, and action in Zabbix. The alert events that are generated based on new alert rules that you create in Zabbix are reported to ARMS.

Note

Before you install the alert management module of ARMS in Zabbix, alert events in Zabbix are not reported to ARMS.

Perform the following operations to check whether the alert management module is installed:

  1. Log on to the Zabbix console.

  2. In the top navigation bar, choose Administration > Users.

    On the Users page, check whether a user named Aliyun Alert User exists. Zabbix user

  3. In the top navigation bar, choose Administration > User groups.

    On the User groups page, check whether a user group named Aliyun Alert Group exists, and whether a member named Aliyun Alert User exists in the user group. Zabbix user group

  4. In the top navigation bar, choose Administration > Media types.

    On the Media types page, check whether a media type named Aliyun Alert Media exists. Alert media type

  5. In the top navigation bar, choose Configuration > Actions.

    On the Actions page, check whether an action named Aliyun Alert Action exists. Zabbix action

    Note

    You can specify custom content to be reported in the Aliyun Alert Action action based on your business requirements.

View the details about an alert event

  1. In the left-side navigation pane of the ARMS console, choose Alert Management > Alert Event History.
  2. On the Alert Event History page, click the name of the alert event to view the event details. For more information, see View historical alert events.

Manage the integration

In the left-side navigation pane, choose Alert Management > Integrations. On the Alert Integration tab, you can perform the following operations on the integrations that you created:

  • View the details of an integration: Find the integration and then click the row. On the Integration Details page, view the integration details.
  • Update a key: Find the Grafana integration and then choose More > Update Key in the Actions column. In the message that appears, click OK.

    Important

    After the key is updated, reinstall the alert management module based on the information in Step 2.

  • Modify an integration: Find the integration and then click Edit in the Actions column. On the Integration Details page, modify the integration information and then click Save.
  • Enable or disable an integration: Find the integration and then click Disable or Enable in the Actions column.
  • Delete an integration: Find the integration and then click Delete in the Actions column. In the message that appears, click OK.
  • Add an event processing flow to an integration: Find the integration and click Add Event Processing Flow in the Actions column. For more information, see Work with event processing flows.
  • Create a notification policy: Find the integration for which you want to create a notification policy, and click More in the Actions column. In the list that appears, click Create Notification Policy. For more information, see Create and manage a notification policy.

What to do next

After you create a notification policy, the system generates alerts and sends alert notifications for reported alert events based on the notification policy that you created. For more information, see Create and manage a notification policy. On the Alert Sending History page, you can view the alerts that are generated based on the configured notification policy. For more information, see View historical alerts.