Freshservice Integration | Cloudmon

Freshservice

Third Party Integration

Freshservice

Automatically raise incidents in Freshservice when Cloudmon alarms fire, and manage them through your ITSM workflow.

Overview

The Freshservice integration allows Cloudmon to raise tickets in your Freshservice account when an alarm fires. If automatic resolution is enabled, Cloudmon also resolves the ticket when the alarm clears, keeping Freshservice in step with your monitoring state without manual intervention.

Before You Begin: Collect Details from Freshservice

Collect the following details in Freshservice before you configure the integration in Cloudmon.

FieldDescription
DomainYour Freshservice host from the browser address bar, for example https://acme.freshservice.com.
API KeyFound in your Freshservice Profile Settings. See Where do I find my API key?.
Requester EmailAn existing Freshservice requester, or leave it for Freshservice to create. See Adding requesters into your service desk.
Agent permissionThe agent behind the API key needs a role that can create and edit tickets. See Manage agent roles and permissions in your Service Desk.
Ticket TagsFree text. Any tag entered in Cloudmon is created in Freshservice on first use. See Tagging.

The API key is stored encrypted and is never shown again after saving. Use Test Connection to verify the domain and key before saving.

Step 1: Configure in Cloudmon

  1. Navigate to Settings → General Settings → Integrations.
  2. Locate the Freshservice widget and click the + Account button.
  3. In the Freshservice Account section, fill in the fields as described in the first table.
  4. Click Test Connection to verify the domain and API key.
  5. In the Ticket Settings section, configure how alarms become tickets, as described in the second table.
  6. Click Save.

Freshservice Account

FieldDescription
Integration NameA display name to identify this integration in Cloudmon, such as "IT Helpdesk".
DomainThe full Freshservice host, for example acme.freshservice.com, or just the sub-domain acme. When only the sub-domain is entered, .freshservice.com is added for you.
API KeyThe API key of the Freshservice agent that Cloudmon uses to create tickets.
Requester EmailThe email address recorded as the requester on tickets created by Cloudmon, for example monitoring@yourcompany.com.

Ticket Settings

FieldDescription
Ticket SubjectThe text used as the ticket subject. The default is $device_name is $severity - $title. Type $ to pick a replaceable tag from the list, and use the reset icon beside the field to restore the default.
Create Tickets For SeveritiesSelect the alarm severities that create a ticket: Down, Critical, Trouble and Attention. The matching priority is shown beside each severity: Down is Urgent, Critical is High, Trouble is Medium and Attention is Low. At least one must be selected.
Resolve Ticket Automatically When Alarm ClearsEnabled by default. When enabled, Cloudmon resolves the ticket when the alarm clears. When disabled, the ticket must be resolved manually.
Ticket TagsOptional. Type a tag and press Enter to add it. Add as many as you need.

The Reset button restores the form to its default values, and Close exits without saving.

Step 2: Enable in Alarm Rules

  1. Navigate to Settings → Configurations → Alarm Rules.
  2. Click the Add button to create a new alarm rule, or open an existing one.
  3. Add a trigger and configure the alarm conditions.
  4. In the THEN section, enable Third Party Services and select the configured Freshservice integration from the dropdown.
  5. Click Save.

When this alarm fires, Cloudmon creates a ticket in Freshservice automatically, for the severities selected in the integration.