[Data] Convert JSON to String with Formatting API on Failed Monitor from Drata API

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

Trigger workflow on

Failed Monitor from the Drata API

Next, do this

[Data] Convert JSON to String with the Formatting API

No credit card required

▶

Watch us build a workflow

4 min

Watch now ➜

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

Developers ♥ Pipedream

Getting Started#

This integration creates a workflow with a Drata trigger and Formatting action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

Select this integration
Configure the Failed Monitor trigger
1. Connect your Drata account
2. Configure timer
3. Optional- Select a Check Type
Configure the [Data] Convert JSON to String action
1. Connect your Formatting account
2. Configure Input
Deploy the workflow
Send a test event to validate your setup
Turn on the trigger

Details#

This integration uses pre-built, source-available components from Pipedream's GitHub repo. These components are 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.

Trigger#

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

Drata Overview#

Drata is a compliance automation platform. Drata’s platform is built by compliance and security experts so you don’t have to be one. With 75+ native integrations, you can easily connect your tech stack and automate evidence collection and testing.

Pipedream customers get 25% off Drata, with implementation fees waived. Visit https://drata.com/partner/pipedream for more information.

Trigger 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);
  },
};

Trigger 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`

Version:0.0.4

Key:formatting-convert-json-to-string

View on GitHub

Action Code#

import { defineAction } from "@pipedream/types";
import app from "../../app/formatting.app.mjs";
export default defineAction({
    name: "[Data] Convert JSON to String",
    description: "Convert an object to a JSON format string",
    key: "formatting-convert-json-to-string",
    version: "0.0.4",
    type: "action",
    props: {
        app,
        input: {
            label: "Input",
            description: "An object to be serialized to a JSON format string.",
            type: "object",
        },
    },
    async run({ $ }) {
        try {
            const result = JSON.stringify(this.input);
            $.export("$summary", "Successfully convert object to JSON string");
            return result;
        }
        catch (err) {
            throw new Error("Error serializing object to JSON string: " + err.toString());
        }
    },
});

Action Configuration#

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

Label	Prop	Type	Description
Formatting	`app`	`app`	This component uses the Formatting app.
Input	`input`	`object`	An object to be serialized to a JSON format string.

[Data] Convert JSON to String with Formatting API on Failed Monitor from Drata API

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

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

Developers ♥ Pipedream

1-24of2,000+apps by most popular

1
-
24
of
2,000+
apps by most popular