Integrations Overview

BigPanda provides several types of integrations that allow you to receive data from your Ops tools and share information with your collaborators through other systems.

Prerequisites

Relevant Permissions

Roles with the following permissions can access the BigPanda Integrations tab:

Role NameDescription
Integrations_ReadRead-only - view BigPanda Integrations in the BigPanda Integrations tab.
Integrations_Full_AccessFull access - view, install, uninstall and/or work with integrations in the BigPanda Integrations tab.

To learn more about how BigPanda's permissions work, see the RBAC - Role Based Access Control guide.

Types of Integrations

BigPanda offers several types of integrations:

  • Monitoring: allows BigPanda to receive alerts from your monitoring systems, such as Nagios, SolarWinds, and AppDynamics. Many users start by integrating these systems.

  • Collaboration: allows you to share incidents from BigPanda with your co-workers through other systems. For example, open JIRA tickets or send Slack notifications.

  • Changes: allows BigPanda to receive change notifications from your change systems, such as CloudTrail, Jenkins, ServiceNow, and Jira.

  • Topology: allows you to enrich alerts coming into BigPanda with topology information from configuration management, cloud and virtualization management, service discovery, APM, and CMDB tools.

Agent vs. Webhook Integrations

BigPanda supports both on-premise and SaaS monitoring tools through different mechanisms.

Many on-premise tools are integrated using the BigPanda agent. The agent is a low-footprint daemon installed on the master host of your monitoring tool. It consumes alerts from the tool in real time, and then transmits them to BigPanda via SSL-encrypted HTTP calls.

Most SaaS tools (such as CloudWatch or New Relic) are integrated using Webhooks. Whenever the SaaS tool generates an alert, it posts an HTTP message directly to BigPanda. BigPanda listens to incoming messages and processes them.

To learn more about using the agent, see the BigPanda Agent documentation.

Available OOTB Integrations

Monitoring

Product

Supported Versions

Type

Authentication Type

Airbrake

SaaS Deployments (Deprecated)

Webhook

API Fortress

SaaS and On-Premise Deployments

Webhook

Bearer Token

AppDynamics

4.1+; On-Premise, Dedicated SaaS Deployments

Webhook

Bearer Token

AppOptics

SaaS Deployments

Webhook

Bearer Token

Azure Monitor

SaaS Deployments

Webhook

Bearer Token

CA Spectrum

9.4.x

Spectrum Scripts

Bearer Token

Catchpoint

SaaS Deployments

Webhook

Bearer Token

CloudWatch

SaaS Deployments

CloudFormation, Webhook

Bearer Token

Datadog

SaaS Deployments

Webhook

Bearer Token

Dataloop.IO

SaaS Deployments (deprecated)

Webhook

Bearer Token

Dynatrace APM

SaaS Deployments

Webhook

Bearer Token

Grafana

Grafana >= v5.0.0

Webhook

Bearer Token

Icinga

1, 2

Agent

Bearer Token

Librato

SaaS Deployments

Webhook

Bearer Token

Logentries

SaaS Deployments

Webhook

Bearer Token

LogicMonitor

SaaS Deployments

Webhook

Bearer Token

Logz.io

SaaS Deployments

Webhook

Bearer Token

Microsoft System Center Operations Manager (SCOM)

System Center 2012 R2 and 2016

Webhook

Bearer Token

Nagios

3, 4

Agent

Bearer Token

Nagios XI

4, 5

Agent

Bearer Token

New Relic

SaaS Deployments

Webhook

Bearer Token

Opsview

Nagios-Compatible Versions (Version 5 and older)

Agent

Bearer Token

Panopta

SaaS Deployments (Depreciated)

Webhook

Pingdom

SaaS Deployments

Webhook

Bearer Token

Prometheus

Alertmanager >= v0.16.0

Webhook

Bearer Token

PRTG

14.4+; English Language (Only)

Webhook

Bearer Token

Scout

SaaS Deployments (Deprecated)

Webhook

Sematext

SasS Deployments

Webhook

Bearer Token

Sensu

0.12+

Webhook

Bearer Token

Sentry

SaaS Deployments

Webhook

Bearer Token

Site24x7

SaaS Deployments

Webhook

Bearer Token

SNMP (Simple Network Management Protocol)

v1, v2, v2c

Daemon and Agent

Bearer Token

SolarWinds

Orion Server, Versions 2015.1+; Network Performance Monitor (NPM) 10.4+

Webhook

Bearer Token

Splunk

4+; On-Premise; Cloud

Native App (v6.3+)
Action Script (pre v6.3)

Bearer Token

StatusCake

SaaS Deployments (Deprecated)

Webhook

Sumo Logic

SaaS Deployments

Webhook

Bearer Token

ThousandEyes

SaaS Deployments

Webhook

Bearer Token

Wavefront

SaaS Deployments

Webhook

Bearer Token

Zabbix

2.2, 3.0, 3.2

Agent

Bearer Token

Zenoss

Zenoss Core 4, 5, 6

Agent

Bearer Token

Collaboration

ProductSupported VersionsTypeAuthentication Type
AsanaSaaS DeploymentsAPIAPI Key
JIRA6+APIAPI Key and Bearer Token
OpsGenieSaaS DeploymentsAPIAPI Key
PagerDutySaaS DeploymentsAPIBearer Token
ServiceNowNew York, Madrid, London, Kingston, Jakarta, Istanbul, Helsinki, Geneva, FujiAPIAPI Key and Bearer Token
SlackSaaS DeploymentsAPIBearer Token
xMatters6+APIAPI Key

️ Deprecated Features

The Airbrake, Panopta, Scout, and StatusCake integrations are no longer being updated and may be removed in a future product version. At this time, they are still available only to current users of those integrations. If you are using these integrations, consider building a custom integration with the Alerts API. Please contact BigPanda support at [email protected] with any questions or feedback.

Root Cause Changes

ProductSupported VersionsTypeAuthentication Type
CloudTrailSaaSAPIAPI Key
Jenkins1.546 or laterNative Plugin, WebhookAPI Key
Jira - ChangesJira Cloud, Jira ServerNative App, WebhookAPI Key and Bearer Token
ServiceNowNew York, Madrid, London, Kingston, Jakarta, Istanbul, Helsinki, Geneva, FujiNative App, APIAPI Key and Bearer Token

Topology

ProductSupported VersionsTypeAuthentication Type
Datadog TopologyBearer Token
Dynatrace TopologySaaS DeploymentsAPIBearer Token
ServiceNowOrlando, New York, Madrid, London, Kingston, Jakarta, Istanbul, Helsinki, Geneva, FujiNative App, APIAPI Key and Bearer Token
vCenter InventoryvCenter Server 6.5 update 2 and newerNative PluginBearer Token

Sample Custom Integration Recipes

️ Using Sample Code

These samples are meant to provide a helpful starting point for your custom integration. Though you may be able to copy some of the samples and use them without modifications, your system administrators must review and test all scripts and methods before using them, as per good practices.

ProductProduct Version DescribedBigPanda APIs Used
Integrating Logentries with BigPandaSaaS version on July 14, 2016Alerts API
Integrating Logz.io with BigPandaSaaS version on Dec. 22, 2016Alerts API
Integrating Sumo Logic with BigPandaSaaS version on Feb. 3, 2016Alerts API
Integrating LogicMonitor with BigPandaSaaSAlerts API
Integrating API FortressOn-Premise Deployments; SaaSAlerts API
Integrating Dataloop with BigPandaSaaS version on July 19, 2016Alerts API
Integrating CA Spectrum with BigPandaCA Spectrum Version 9.4.xAlerts API

Integrating Your First Monitoring Service

To get started, integrate your monitoring services with BigPanda. After integrating your services, you can see and manage your alerts from within the BigPanda interface.

Prerequisites

Integrating a Monitoring Service

Administrators can install any of the available integrations in BigPanda.

  1. Log in to BigPanda, and click the Integrations tab at the top of the screen.
  2. In the left pane, click New Integration.
  3. Click the desired integration. The installation instructions open.

👍

Finding Integrations

You can filter the list of available integrations by clicking the Monitoring tab in the top left or by entering a search term in the top right. If you don't see the tool you use, consider using the Alerts REST API or contact BigPanda support.

  1. Follow the instructions to install and configure your integration.

Checking the Status of Integrations

  1. At the top of the screen, click the Integrations tab. The left pane shows the name and recent activity for each installed integration.

️ Multiple Integrations For A Single System

If you’ve configured multiple integrations of the same type, each integration is listed separately in the left pane.

  1. (Optional) Filter the list of installed integrations by entering a search term.
  2. Review the colored ribbons on the left of each listing to check the status of your integrations.
  • Pending (orange indicator): The integration has been configured but no data has been received from it yet. The source system may not have generated alerts yet, or the integration may not be configured correctly.
  • Installed (green indicator): The integration is working properly.
  1. Click the desired integration. The integration details appear in the right pane.

👍

Renaming Integrations

To rename the integration, click Edit Name beside its name. Then, enter the new name up to 20 characters long, and press Enter.

  1. If the integration is pending but the source system has generated alerts since you integrated it, click Review Instructions and ensure it is configured correctly.
  2. If you receive error indicators on your integration tiles, review the information presented in the Troubleshooting log and troubleshoot your errors to resolve the issues within your integrated system.
    Contact BigPanda support for more help, if needed.

Post-Requisites

Manage Incidents using Incident Feed.

Deleting an Integration

You may want to remove an integration that you have installed in BigPanda. For example, when you are upgrading to a new version or if your infrastructure changes. In general, deleting an integration requires changes to both the integrated system and BigPanda. You must uninstall the integration on the integrated system and then delete the integration from BigPanda.

Prerequisites

  • Manually resolve any open incidents related to the integration to remove them from your incident feed. Optionally, remove any additional data in BigPanda. For example, modify or remove any Environments or AutoShare rules that reference the integration.
  • (Optional) Delete any shared data that was posted in the integrated system. For example, close any incident tickets opened by BigPanda in the target system.

Uninstalling an Integration

  1. On the integrated system, disable any settings that send events to BigPanda or receive shared data from BigPanda.

Each system requires specific changes to disable the integration with BigPanda. For example, you must delete the topic in CloudWatch, and you must disable the alert channel in New Relic. To determine the changes for your integrated system, reference the relevant documentation or contact BigPanda support.

  1. If the integration is agent-based, uninstall the agent from the server.

Deleting An Integration From BigPanda

Administrators can request permanent deletion of existing integrations from the BigPanda UI.

This procedure does not remove any data from BigPanda or the integrated system. As needed, remove data from each system before deleting the integration.

  1. In BigPanda, click the Integrations tab at the top of the screen.
  2. (Optional) Filter the list of installed integrations by entering a search term.
  3. Click the integration you want to delete.
  4. In the right pane, click Delete Integration. The message window opens and is pre-populated with a request to delete the selected integration.
  5. Press Enter to send the request.
    The BigPanda support team will remove the integration from the UI.

Reference: Integrations Tab

Use this reference guide to quickly find out what each item on the Integrations tab means, then follow the links to learn more about a feature.

Integrations Tab

The Integrations tab provides a centralized place to manage your integrations with BigPanda.

ItemDescriptionRelated Links
Left PaneLists basic information about each installed integration and provides a filter to search for a specific integration.- Integrating Your First Monitoring Service - Available Integrations
Information Center(No integration selected) Provides links to helpful information about BigPanda.Getting Help
Integration Details(Integration selected) Shows detailed information about the integration selected in the left pane. You can see the status, review the configuration instructions, change the name, or delete the integration.- Integrating Your First Monitoring Service - Deleting an Integration

Integrations List Item

Item

Description

Related Links

Status Indicator

Displays a colored ribbon on the left to indicate the status of the integration, which is determined by whether data has been received from or sent to the integrated system.

Integrating Your First Monitoring Service

System

Shows the integration type (such as Nagios or Zabbix).

Available Integrations

Name

Shows the integration name (such as Production).

Integrating Your First Monitoring Service.

Activity Summary

Shows a summary of recent activity for the integration:

  • For monitoring integrations, the most recent event received from the source system.

  • For collaboration integrations, the amount of the daily sharing quota that has been used today.

Integration Details

Item

Description

Related Links

Status Indicator

Displays a colored ribbon on the left to indicate the status of the integration, which is determined by whether data has been received from or sent to the integrated system.

Integrating Your First Monitoring Service

System

Shows the integration type (such as Nagios or Zabbix).

Available Integrations

Name

Shows the integration name (such as Production). You can change the name of an installed integration.

Integrating Your First Monitoring Service

App Key

Shows the unique identifier for the integration, if applicable.

Activity History

Shows the activity history, depending on the integration type and status:

  • If no data has been received from the integrated system, a Pending status explanation.

  • For active monitoring integrations, the date of the first event and the most recent event received.

  • For collaboration integrations, the amount of the daily sharing quota that has been used today.

Review Instructions

Opens the installation instructions for the integration.

Integrating Your First Monitoring Service

Created

Shows the date the integration was installed.

Integrating Your First Monitoring Service

Delete Integration

Allows you to send a request to delete the selected integration.

Deleting an Integration

Creating a New Integration

ItemDescriptionRelated Links
TabsFilters the list of available integrations by type.Integrating Your First Monitoring Service
SearchFilters the list of available integrations by the search term. Enter the name of your tool to find it quickly.Integrating Your First Monitoring Service
Available IntegrationsShows all available integrations that match the selected tab and the search term. Select an integration to open the installation instructions.Available Integrations