Skip to main content

About BigPanda

BigPanda is an AIOps platform that aggregates alerts from your monitoring tools, correlates them into actionable incidents, and helps teams detect, investigate, and resolve outages faster.

What the BigPanda integration enables

CapabilityDescription
Automation workflowsManage incidents, alerts, environments, enrichment, maintenance plans, and more through BigPanda’s API
Incident ManagementAutomate incident retrieval, commenting, tagging, and resolution workflows
Alert IngestionSend and resolve alerts via the Alerts API and Open Integration Manager
Anything defined in the BigPanda Public API can be accessed through Serval. This covers both the primary REST API (api.bigpanda.io) and the Open Integration Manager / ingestion endpoints (integrations.bigpanda.io).

BigPanda Configuration

To connect BigPanda to Serval, you’ll need a BigPanda Bearer token. BigPanda supports two token types:
Token TypeDescription
User API Key (recommended)Associated with a specific user and limited by the permissions assigned to that user’s roles. Provides better audit logging and scoped security controls.
Org TokenA single organization-wide token used by integrations. Not tied to an individual user, so actions are harder to audit.

1. Prerequisites

  1. Permissions – Your BigPanda user’s roles must permit the API resources you plan to automate (User API Keys inherit the creating user’s permissions; Org Tokens require admin access with integrations access to retrieve)
  2. BigPanda Web UI access – Tokens are retrieved or generated from the BigPanda web interface
  1. Sign in to BigPanda and open Settings
  2. Navigate to the API Keys menu
  3. Click to create a new API key and give it a descriptive name, e.g., “Serval Production Integration”
  4. Important: Copy the key value immediately – it will only be displayed once
  5. Store the key securely in your secret management system
See BigPanda’s API Key Management documentation for more details.

Alternative: Find your Org Token

  1. Sign in to BigPanda as an administrator with integrations access
  2. Click the Integrations tab at the top of the screen
  3. Open the setup instructions for any integration that uses the Alerts API – your org Bearer token appears in the example request headers
Security Note: Treat BigPanda tokens like passwords. They provide access to your BigPanda organization based on their scope and should be stored securely and rotated regularly.

Serval Configuration

Once you have your BigPanda token, follow these steps to connect it to Serval.
  1. In Serval, navigate to Apps → Available → BigPanda → Connect
  2. Enter the following:
    FieldDescription
    Instance NameFriendly name for the BigPanda instance (e.g., “Production BigPanda”)
    API TokenThe User API Key or Org Token you retrieved above
  3. Click Save to complete the connection
Serval’s BigPanda integration targets BigPanda’s US API endpoints (api.bigpanda.io and integrations.bigpanda.io). If your organization is hosted in BigPanda’s EU environment, contact Serval support before connecting.