Logentries

Logentries provides IT teams with real-time log data monitoring for systems, apps, and services. Build this integration to correlate Logentries alerts into high-level incidents in BigPanda.

Supported Versions:
SaaS Version on July 14, 2016

Type:
Webhook

How It Works

Logentries is an easy-to-use, self-hosted log management and analytics service for teams of all sizes.

For a brief, high-level overview of Logentries, the 5-minute demo video below offers an introduction to Logentries’ capabilities:

https://vimeo.com/116089337

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.

Prerequisites

  • Logentries account.

  • Existing Logentries alerts or ability to create new alerts.

  • BigPanda account.

  • Understanding of BigPanda Alerts API.

  • Identify the active server that will run the GitHub script.

Step 1: In BigPanda, create an App Key.

  1. In BigPanda, click the Integrations tab at the top of the screen.

  2. In the left pane, click New Integration.

  3. On the Monitoring tab, click Alerts REST API.

  4. In Step 1, enter the name of the integration.For example, enter Logentries.

  5. Click Generate App Key.

Step 2: In Logentries, configure the Webhook to send alerts to BigPanda.

  1. In Logentries, go to Tags & Alerts.

  2. Create a new tag and alert or edit an existing alert by clicking Edit beside it.

  3. In Add an Alert, ensure all alerts are sent to BigPanda by using the recommended settings:

    • Match: Once, one per hour.
    • Report: 100 per hour.
    • Send to: Leave blank.
  1. Expand Other Options and select the Webhook option.

  2. Enter the IP address and port of the server that will run the script, then Save your changes.
    The provided script defaults to port 10000.

Step 3. Install the Logentries and BigPanda script.

  1. Download and save the Logentries BigPanda Community GitHub script to the active server that will run it.

  2. Edit the script to contain:

    • BigPanda Bearer Header key - Located on the Alerts API integration screen under the HTTP headers section.

    • BigPanda App key - Located on the Alerts API integration screen under the step one.

    • Port (default 10000) - The port of the machine running the script.

  3. Run the twistd proxy server sudo twistd -y bigpanda_proxy.py to start the web server.

You will notice after running this command, twistd generates a log file in the same directory. You can check this to verify everything is ok.

  1. (Optional) In Logentries, verify the correct alert webhook URL is in use.
    If required, replace the URL with the correct IP address and port. For example:

    • http://127.0.0.1:10000/form.

Step 4. Test the integration by sending a test alert from Logentries.

  1. From a command window, trigger an alert by sending test data to Logentries. For example:

    • telnet-ssl -z ssl data.Logentries.com 443 100002bfbea1e-10c3-4419-bdad-7e6435882e1f status = 500
  2. Log in to BigPanda to see your newly created alert.

Post-Requisites

  • Add another alert to an existing search, if required.

  • Create more alerts in Logentries for other statuses; for example, warning, critical or ok alerts.

Logentries Incidents Do Not Close Automatically

Logentries incidents are not closed automatically because Logentries does not send notifications when alerts are resolved. You must manually resolve Logentries incidents in BigPanda to remove them from the incident feed or create alerts with an ok status to automatically clear events.

Logentries


Logentries provides IT teams with real-time log data monitoring for systems, apps, and services. Build this integration to correlate Logentries alerts into high-level incidents in BigPanda.

Suggested Edits are limited on API Reference Pages

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