Papertrail Integration

Papertrail provides hosted log management, live in minutes. It sites on-file systems where nobody sees and is not easily consumable via the Web, command-line, API, or email, let alone by whole systems.

What does Opsgenie offer Papertrail users?

Use Opsgenie's Papertrail Integration to forward Papertrail alerts to Opsgenie. Opsgenie determines the right people to notify based on on-call schedules– notifies via email, text messages (SMS), phone calls, and iOS & Android push notifications, and escalates alerts until the alert is acknowledged or closed.

Functionality of the integration

  • When an alert is created on Papertrail, an alert is created in Opsgenie automatically through the integration.

📘

If the data from Papertrail is too big (larger than 200KB), the oldest "events" data is cropped until the size is smaller than or equal to 200KB and use the newest "events".

Add Papertrail Integration in Opsgenie

  1. Please create an Opsgenie account if you haven't done so already.
  2. Go to Opsgenie's Papertrail Integration page.

🚧

For Free and Essentials plans, you can only add the integrations from the Team Dashboards, please use the alternative instructions given below to add this integration.

  1. Specify who is notified of Papertrail alerts using the Teams field. Auto-complete suggestions are provided as you type.

📘

An alternative for Step 2) and Step 3) is to add the integration from the Team Dashboard of the team which will own the integration. To add an integration directly to a team, navigate to the Team Dashboard and open Integrations tab. Click Add Integration and select the integration that you would like to add.

  1. Copy the Webhook URL.
  2. Click Save Integration.

Configuration in Papertrail

  1. Go to Papertrail's dashboard.
  2. Click Search.
  3. Click Create Alert or Manage Alerts
  4. Click *Webhook** and paste the Webhook URL into the field.
  5. Select Every minute as Frequency.
  6. Verify that "Activate this alert" is checked and click on Update.

See Papertrail support for more on Papertrail alerts.

Sample Payload

{
  "min_time_at": "2014-01-17T10:10:16Z",
  "reached_record_limit": true,
  "min_id": "360778065477173251",
  "max_id": "360819921921572867",
  "events": [
    {
      "hostname": "ismet-if",
      "severity": "Info",
      "received_at": "2014-01-17T12:10:16+02:00",
      "message": "Format: 1 Sampling rate: 44100Hz Offloaded: false",
      "source_name": "ismet-if",
      "display_received_at": "Jan 17 12:10:16",
      "facility": "User",
      "source_id": 19642663,
      "program": "Microsoft-Windows-Audio",
      "id": 360778065477173250,
      "source_ip": "78.187.83.243"
    },
    {
      "hostname": "ismet-if",
      "severity": "Info",
      "received_at": "2014-01-17T12:10:16+02:00",
      "message": "Format: 1 Sampling rate: 44100Hz Offloaded: false",
      "source_name": "ismet-if",
      "display_received_at": "Jan 17 12:10:16",
      "facility": "User",
      "source_id": 19642663,
      "program": "Microsoft-Windows-Audio",
      "id": 360778065477173250,
      "source_ip": "78.187.83.243"
    }
  ],
  "saved_search": {
    "html_edit_url": "https://papertrailapp.com/searches/1382953/edit",
    "html_search_url": "https://papertrailapp.com/searches/1382953",
    "name": "sampli",
    "id": 1382953,
    "query": "Sampling rate"
  }
}

Sample alert

Updated 10 months ago


Papertrail Integration


Papertrail provides hosted log management, live in minutes. It sites on-file systems where nobody sees and is not easily consumable via the Web, command-line, API, or email, let alone by whole systems.

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.