Skip to main content

Zabbix Connector

This connector imports hosts from Zabbix into Alvao as objects, and creates a ticket in Alvao whenever an event is detected in Zabbix. It can also resolve the Alvao ticket on resolution of the Zabbix event.

Requirements​

  • ALVAO Asset Management and ALVAO Service Desk
  • Zabbix

Importing hosts from Zabbix to Alvao​

Setting up Zabbix​

  1. Create a user group:

    • Group name - enter Alvao Connector group.
    • Host permissions tab - add the Read permission to the host groups you want to synchronize with Alvao.

  2. Create a user:

    • Username - enter Alvao Connector.
    • Groups - select Alvao Connector group.
    • Permissions tab - select or create a role with Access to API permission (host.get method).

  3. Create API token:

    • Name - enter Alvao Connector token.
    • User - enter Alvao Connector.
    • Expires at - choose expiration period, e.g., in 1 year.
    • Copy the generated token and keep it in a safe place.

Setting up Alvao​

  1. Go to Administration – Applications and import the ZabbixConnector.xml file.

  1. Go to Administration – Settings – Advanced and create and fill the following settings:

    • Zabbix.Token – enter the token created in previous steps.
    • Zabbix.Url - enter your zabbix frontend Url, e.g., https://zabbix.contoso.com.

  2. Enable the application imported in step 1.

  3. In one hour, new objects representing Zabbix hosts will be created in the Imported objects folder on the Objects page.

Creating and resolving Alvao tickets based on Zabbix events​

Setting up Alvao​

  1. Go to Administration – Services and import the Zabbix incident service template.

    :::note:

    Instead of this step you may also add the Objects field and following custom fields to your existing service process:

    • Zabbix event ID - type: nvarchar 256, tHdTicketCust.zabbixEventId
    • Zabbix trigger ID - type: nvarchar 256, tHdTicketCust.zabbixTriggerId

    :::

  2. Create an application account, set its password and assign it the main solver and requester role of the previously created service.

Setting up Zabbix​

Create media type​

  1. Go to Alerts - Media types and import the AlvaoZabbixMediaType.xml file.

  1. Open imported media type and setup following parameters:

    • alvao_url – URL of Alvao REST API , e.g., https://contoso.onalvao.com/AlvaoRestApi.
    • alvao_user – user name of the Alvao application account
    • alvao_password – password of the Alvao application account
    • alvao_service_id – ID of Alvao service. You can view it in the url of the Administration - Service Desk - Services - Service page of the particular service.
    • alvao_requester_id – ID of ticket requester. Use same value as for the alvao_user parameter.

  2. Replace the <alvao url> tag with the Alvao address in the Menu entry URL field, e.g., https://contoso.onalvao.com/Ticket/{EVENT.TAGS.alvao_ticket_id}.

  3. Optionally customize the Subject (ticket name) and Message (ticket description) on the Message template tab.

Set up trigger actions​

  1. Go to Alerts - Actions - Trigger actions – Create action.

  2. On the Action tab, fill in the Name and Conditions as needed.

  3. On the Operations tab:

    • Add operation in the Operation section: set Send to user groups or Send to users and in the Send only field select previously created Alvao media type.

    • If you want the ticket to be automatically resolved, add the same operation in Recovery operations section and ensure that the Alvao process allows resolving ticket from any other ticket status.