Last updated: 2023-09-28

Source: https://support.freshservice.com/support/solutions/articles/50000003707-integrate-freshping-with-freshservice-alert-management

Identify and resolve website issues faster by piping notification from Freshping into Freshservice Alert Management. Benefit from reduced noise and automated creation and routing of rich incidents.

Configuration in Freshservice:

Step 1:

Head to the Admin panel, scroll down to IT Operations Management, and select Monitoring Tools.

If your account has more than one workspace, navigate to Admin > {Worskpace Name} > IT Operations Management> Monitoring Tools.

Step 2:

You are now on the Monitoring Tools list page. Select Add monitoring tool to add a new integration.

Step 3

You will see a list of pre-configured integrations, the gateway to custom integration using webhooks, and the option to use email as a channel for alerts. Select *Freshping*

Step 4

Getthe Endpoint URL and the Auth key for Freshping by following theintegration setup.

Configuration in Freshping

1. Go to Freshping and Navigate to Settings -> Integration. 2. Under Webhook click on Create Integration and paste the copied endpoint URL and click on Create

Once you've configured the integration, it’ll be listed in the integrations page Choose to enable/ disable the integration at any point

Click on +Add integration on the right to create new integrations for your monitoring tools

Where can I find my Freshping account domain and API Key?

1. Login to your Freshping account

2. Navigate to Settings > Account Settings in your Freshping account, where you can find your Freshping account domain name or in short Freshping URL

3. You can find the API Key right below in the second section

Once Freshping is selected and the Alert Profile is created, follow the steps listed below:

Step 1: Configure Incoming Alerts

1. Add the Name and Description of your integration. For default integrations, we display a sample content of the alert sent from the monitoring tool. You can choose to edit it if you have configured a custom content in your alert notifications.

2. Configure Alert Content - Freshping Payload

3. Once you're done click on Save & Next

Freshping Webhook test data

{

    "request\_start\_time": "2021-01-20T14:54:04.197877+00:00",

    "check\_target\_response\_time": 100,

    "check\_id": 1,

    "recently\_started\_check\_start\_time": null,

    "recently\_started\_check\_http\_status\_code": null,

    "http\_status\_code": 200,

    "check\_state\_name": "Available",

    "check\_name": "Example check",

    "recently\_started\_check\_state\_name": null,

    "application\_name": "Webhook test",

    "recently\_started\_check\_response\_time": null,

    "request\_url": " https://www.example.com/",

    "check\_computed\_target\_response\_time": 200,

    "response\_time": 50

}

Freshping Production Live Data

{

"request\_start\_time": "2021-01-21T11:28:01.651346+00:00",

"application\_id": 9004,

"check\_id": 30979,

"recently\_started\_check\_start\_time": null,

"recently\_started\_check\_http\_status\_code": null,

"http\_status\_code": 200,

"check\_state\_name": "Degraded Performance",

"check\_name": "ABC Track Admin UI",

"recently\_started\_check\_state\_name": null,

"recently\_started\_check\_response\_time": null,

"application\_name": "Default Group",

"check\_target\_response\_time": 1000.0,

"request\_url": " https://abc.com/track/admin/ping",

"check\_computed\_target\_response\_time": 1000.0,

"response\_time": 9253

}

Step 2: Map Alert fields

You can configure the alert information that you want to see in Freshservice to be able to effectively resolve any issue. Alert notifications generated repeatedly for the same issue are grouped based on Resource and Metric values and created as a single alert record in Freshservice.

1. Hover over the alert fields and click on the "+" icon to map the alert fields in your monitoring tool to the corresponding Freshservice fields

Freshservice Alert FieldsDescriptionFreshping Payload
ResourceDenotes the name of the monitored entity. It could be the hostname, application name or service name based on the type of the resource. Ex : BLR\_PEPLINK, IBM\_asset, RDS, ELB,etc<br>This field is mandatory.Check\_name<br>ABC Track Admin UI (Live Data)
Metric NameThe performance aspect of the resource that is monitored. Ex: CPU Utilisation, Throughput, etc<br>This field is mandatoryCheck\_name<br>ABC Track Admin UI (Live Data)
Metric ValueValue of the monitored metric. Ex: 50% CPU UtilisedResponse\_time<br>9253 (Live Data)
NodeDenotes the MAC address or IP address of the machine-
MessageMessage denotes the context of the alert.
DescriptionDescription of the issueHttp\_status\_code<br>check\_computed\_target\_response\_time<br>200 (Live Data )<br>1000 (Live Data)
SeveritySeverity denotes the impact of the alert and the urgency with which it has been acted uponCheck\_state\_name<br>Degraded Performance (Live Data)
TagsTags help you classify the incoming alerts using keywords-
Additional InformationSelect up to 5 fields to additional information about your alertRequest\_url,check\_id,http\_status\_code,application\_name<br>https://abc.com/track/admin/ping (Live Data)<br>30979 (Live Data)<br>Default Group (Live Data)
Occurrence TimeTime of creation of an alertRequest\_start\_time<br>2021-01-21T11:28:01.651346+00:00 (Live Data)

Click on Save & Next to proceed to the next step

Step 3: Map Alert Severity

Severities help you understand how quickly an issue has to be acted upon. You can filter alerts based on the alert severity mapping

1. Map the severity of an alert from your monitoring tool (Freshping) to a corresponding severity in Freshservice and click Save and Next

Severity ( Freshservice)Severity ( Freshping )
CriticalNot Responding,<br>String Check Matching failure,                                              <br>Status Code check failure
ErrorReporting Error
WarningPerformance Degraded
OKAvailable,<br>Good Performance

Step 4: Authorise Integration

1. Copy the Endpoint URL to be configured in your Freshping Monitoring tool

2. Click on Enable

3. Go to Freshping and Navigate to Settings -> Integration.

4. Under Webhook click on The Create Integration and Paste the Copied Endpoint URL and click on Create

Once you've configured the integration, it’ll be listed in the integrations page

1. Choose to enable/ disable the integration at any point

2. Click on +Add integration on the right to create new integrations for your monitoring tools