Define a custom integration

Create your own integration (CYOI) lets you use a webhook configured in an external service to send events or metrics to Moogsoft Cloud.

NOTE: Refer to Ingestion methods before you start. Step-by-step instructions are available for configuring several external systems with CYOI.

The Data Config > Ingestion Services > Create your own Integration page lists the custom integrations defined in your Moogsoft Cloud instance. Each integration specifies the following:

  • A user-defined endpoint for ingesting events or metrics from a third-party service

  • A set of mappings from the third-party metric/event fields to their Moogsoft Cloud equivalents.

  • A deduplication key that defines the fields used to identify duplicate events.

Before you begin

Before you create a custom API, do the following:

  1. Verify that you can create a webhook in the third-party service.

  2. Verify that the third-party service can post REST requests with JSON payloads over port 443.

  3. Review the JSON payloads generated by the external service and compare them with the Moogsoft Events API or Metrics API schema.

Procedure

Follow these general steps to create an custom integration: