AppFormix Integration Guide

AppFormix is a real time monitoring and analytics tool which enables operators and developers to know how resources are being consumed by VMs, Containers and Applications throughout the data center in real time. AppFormix integration with PagerDuty is done through PagerDuty Connect.

In PagerDuty

1. Go to the Services menu and select Service Directory.
2. On the Service Directory page:
   • If you are creating a new service for your integration, click +New Service and follow the steps outlined, selecting this integration in step 4.
   • If you are adding your integration to an existing service, click the name of the service you want to add the integration to. Then click the Integrations tab and click Add a new integration.
3. Under Select the integration(s) you use to send alerts to this service search and select this integration.
4. Click the Add Service or Add Integration button to save your new integration. You will be redirected to the Integrations page for your service.
5. Find the integration in the list, copy the Integration Key and keep it in a safe place for later use.

In AppFormix

1. 1. 1. From the dashboard, navigate to ‘Settings’ from the dropdown menu in the upper right hand corner.

      2. Choose ‘Alert Settings’ from the settings menu, then click the ‘Alert with PagerDuty’ button.

      3. When prompted, log in to PagerDuty. If your account uses a Single Sign-on Provider, you’ll need to use that.

      4. Choose an existing PagerDuty service from the dropdown menu or create a new one, then click ‘Finish Integration’.

         The menu will automatically be populated with any existing AppFormix-integrated services.

      5. Now when you go to ‘Alert Settings’, you will see the PagerDuty service you selected. Once you’ve confirmed that this is the service you want, head over to the Event Stream to set up an alert.

Setting up an alert

1. 1. 1. From the Event Stream, click the ‘+’ at the top of the ‘Alert Rules’ column.

      2. Name your alert and define the thresholds, alert type and other conditions that will trigger this alert.

      3. At the bottom of the list, under ‘Notification’, select ‘PagerDuty’ from the dropdown.

      4. Once you’ve selected PagerDuty, another dropdown will appear with the names and integration keys of all of your linked PagerDuty services. Choose the service to which you’d like to send alerts and then click ‘Save’.

Verify that AppFormix and PagerDuty are communicating

1. 1. 1. To test that your AppFormix alert is communicating with PagerDuty, we’d recommend starting with a predictable metric and a relatively low threshold.
      2. Your alert will be active as soon as you’ve saved your changes, so a PagerDuty incident should be triggered once the conditions you’ve established become true. The incident details will contain a snapshot of the parameters you’ve chosen to monitor.

FAQ

Will the PagerDuty incident resolve when the specified parameter returns to a normal status?

Yes. AppFormix will test that parameter against the rules you’ve established and send updates to PagerDuty at the time interval you specified when you created the alert. Once the conditions are no longer true, AppFormix will update PagerDuty to resolve the incident.