Failed Monitor from Drata API

Pipedream makes it easy to connect APIs for Drata and 2,400+ other apps remarkably fast.

Trigger workflow on

Failed Monitor from the Drata API

Next, do this

Connect to 2,400+ APIs using code and no-code building blocks

No credit card required

▶

Watch us build a workflow

8 min

Watch now ➜

Trusted by 1,000,000+ developers from startups to Fortune 500 companies

Developers ♥ Pipedream

Getting Started#

Trigger a workflow on Failed Monitor with Drata API. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Configure the Failed Monitor trigger
1. Connect your Drata account
2. Configure timer
3. Optional- Select a Check Type
Add steps to connect to 2,400+ APIs using code and no-code building blocks
Deploy the workflow
Send a test event to validate your setup
Turn on the trigger

Integrations#

Send Message with Discord Webhook API on Failed Monitor from Drata API

Drata + Discord Webhook

Try it

Get Film with SWAPI - Star Wars API on Failed Monitor from Drata API

Drata + SWAPI - Star Wars

Try it

Create Multiple Records with Airtable API on Failed Monitor from Drata API

Drata + Airtable (API Key)

Try it

Send any HTTP Request with HTTP / Webhook API on Failed Monitor from Drata API

Drata + HTTP / Webhook

Try it

Get Backlinks with Ahrefs API on Failed Monitor from Drata API

Drata + Ahrefs

Try it

Details#

This is a pre-built, source-available component from Pipedream's GitHub repo. The component is developed by Pipedream and the community, and verified and maintained by Pipedream.

To contribute an update to an existing component or create a new component, create a PR on GitHub. If you're new to Pipedream component development, you can start with quickstarts for trigger span and action development, and then review the component API reference.

Failed Monitor on Drata

Description:Emit a new event whenever a monitor fails. [See the documentation](https://developers.drata.com/docs/openapi/reference/operation/MonitorsPublicController_listMonitors/).

Version:0.0.2

Key:drata-failed-monitor

View on GitHub

Code#

import drata from "../../drata.app.mjs";
import { DEFAULT_POLLING_SOURCE_TIMER_INTERVAL } from "@pipedream/platform";

const docsLink = "https://developers.drata.com/docs/openapi/reference/operation/MonitorsPublicController_listMonitors/";

export default {
  key: "drata-failed-monitor",
  name: "Failed Monitor",
  description: `Emit a new event whenever a monitor fails. [See the documentation](${docsLink}).`,
  type: "source",
  version: "0.0.2",
  dedupe: "unique",
  props: {
    drata,
    db: "$.service.db",
    timer: {
      type: "$.interface.timer",
      default: {
        intervalSeconds: DEFAULT_POLLING_SOURCE_TIMER_INTERVAL,
      },
    },
    checkType: {
      type: "string",
      label: "Check Type",
      description: "Filter monitors by check type (associated monitor instances)",
      optional: true,
      options: [
        "POLICY",
        "IN_DRATA",
        "AGENT",
        "INFRASTRUCTURE",
        "VERSION_CONTROL",
        "IDENTITY",
        "TICKETING",
        "HRIS",
        "OBSERVABILITY",
      ],
    },
  },
  hooks: {
    async deploy() {
      const response = await this.drata.listMonitors({
        paginate: true,
        params: {
          checkResultStatus: "FAILED",
          reportInterval: "WEEKLY",
        },
      });

      const visitedIds = {};
      for (const monitor of response.data) {
        const ts = Date.parse(monitor.lastCheck);
        visitedIds[monitor.id] = ts;

        this.$emit(monitor, {
          id: `${monitor.id}_${ts}`,
          summary: `Historical failed monitor event: ${monitor.name}`,
          ts,
        });
      }

      this._setVisitedIds(visitedIds);
    },
  },
  methods: {
    _getVisitedIds() {
      return this.db.get("visitedIds") || {};
    },
    _setVisitedIds(visitedIds) {
      this.db.set("visitedIds", visitedIds);
    },
  },
  async run() {
    const visitedIds = this._getVisitedIds();

    const response = await this.drata.listMonitors({
      paginate: true,
      params: {
        checkResultStatus: "FAILED",
        reportInterval: "WEEKLY",
      },
    });

    for (const monitor of response.data) {
      const id = monitor.id;
      const ts = Date.parse(monitor.lastCheck);

      if (!visitedIds[id] || ts > visitedIds[id]) {
        visitedIds[id] = ts;

        this.$emit(monitor, {
          id: `${monitor.id}_${ts}`,
          summary: `Failed: ${monitor.name}`,
          ts,
        });
      }
    }

    this._setVisitedIds(visitedIds);
  },
};

Configuration#

This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI and CLI.

Label	Prop	Type	Description
Drata	`drata`	`app`	This component uses the Drata app.
N/A	`db`	`$.service.db`	This component uses `$.service.db` to maintain state between executions.
	`timer`	`$.interface.timer`
Check Type	`checkType`	`string`	Select a value from the drop down menu:`POLICYIN_DRATAAGENTINFRASTRUCTUREVERSION_CONTROLIDENTITYTICKETINGHRISOBSERVABILITY`