Events Integration API Overview

The inbound Events API provides an endpoint where you can send events from monitoring tools such as New Relic, Dynatrace, and Datadog. Moogsoft can ingest from any external tool that can publish event data in JSON format.

The Events API supports the following workflows:

  • Posting: Set up a simple script that regularly posts events to the REST endpoint.

  • Webhook: Set up the REST Integration as an endpoint for a webhook from an external tool.

To send events of interest to Moogsoft, go to Data Config > Integrations > Events API. This page includes a full description of the metric schema and required fields; it also includes auto-generated cURL commands with example JSON events.

The event schema is highly flexible and generic, with a small number of required fields, a larger number of optional fields, and a tag field for ingesting custom data not included in the default schema.

For a description of how Moogsoft deduplicates events and adds them to alerts, see Deduplicate events to reduce noise.

Before you begin

Before you set up your integration, note the following:

  • Make sure that the event data you send to Moogsoft includes all data fields required by the schema, as well as any additional fields necessary to cluster alerts intelligently and create incidents that meet the needs of your users.

    If your raw data doesn't include all the data you need, map the missing fields to a value like "incomplete event" to handle these events separately.

  • All times must be specified as UNIX time values normalized to Coordinated Universal Time (UTC).

  • Moogsoft stores all times in UTC format. The dates and times displayed in the UI are based on your browser's local time.

  • Make sure that any subsequent updates to an event are consistently populated.

  • Review the following topics:

Set up an events integration

To set up an event integration, you configure the external tool to publish to the Events API endpoint of your Moogsoft instance. The general workflow is the same regardless of the tool:

  1. Go to the Moogsoft web UI > Data Config > Integrations > Events API and determine the data fields that you want to ingest.

  2. In the external tool, do the following:

    1. Determine the event types that you want to send to Moogsoft.

    2. Set up the tool to trigger alerts for the infrastructure issues of interest.

    3. Set up the tool to send events to the Events API endpoint in the required format.