arazzo: 1.0.1
info:
title: Datadog Post and Search Events
summary: Post an event to the Events Explorer, then search events to find it.
description: >-
A correlation pattern for Datadog events such as deployment markers. The
workflow posts a new event with a title, message, tags, and alert type to
the Events Explorer, then runs a structured search over a time range to
locate matching events. Every step spells out its request inline so the
flow can be read and executed without opening the underlying OpenAPI
description.
version: 1.0.0
sourceDescriptions:
- name: eventsApi
url: ../openapi/datadog-events-api-openapi.yml
type: openapi
workflows:
- workflowId: post-and-search-events
summary: Post an event then search the Events Explorer for matches.
description: >-
Creates an event in the Events Explorer and then searches events over a
time range using the Datadog events query language.
inputs:
type: object
required:
- title
- searchQuery
properties:
title:
type: string
description: The event title displayed in the Events Explorer (max 100 chars).
message:
type: string
description: The event body text with additional details (max 4000 chars).
host:
type: string
description: The hostname to associate with the event.
tags:
type: array
description: List of tags to apply to the event in key:value format.
items:
type: string
alertType:
type: string
description: The alert type category (error, warning, info, success, etc.).
searchQuery:
type: string
description: A Datadog events search query (e.g. source:deploy tags:env:prod).
searchFrom:
type: string
description: Start of the search time range (ISO 8601 or relative, e.g. now-1h).
searchTo:
type: string
description: End of the search time range (ISO 8601 or relative, e.g. now).
steps:
- stepId: postEvent
description: >-
Create a new event in the Events Explorer with a title, message, tags,
and alert type for visual categorization.
operationId: CreateEvent
requestBody:
contentType: application/json
payload:
data:
type: event
attributes:
title: $inputs.title
message: $inputs.message
host: $inputs.host
tags: $inputs.tags
alert_type: $inputs.alertType
successCriteria:
- condition: $statusCode == 202
outputs:
status: $response.body#/status
eventId: $response.body#/event_id
- stepId: searchEvents
description: >-
Search the Events Explorer over the supplied time range to locate the
posted event and any related matches.
operationId: SearchEvents
requestBody:
contentType: application/json
payload:
filter:
query: $inputs.searchQuery
from: $inputs.searchFrom
to: $inputs.searchTo
sort: -timestamp
page:
limit: 25
successCriteria:
- condition: $statusCode == 200
outputs:
matchedEvents: $response.body#/data
firstMatchId: $response.body#/data/0/id
outputs:
postedEventId: $steps.postEvent.outputs.eventId
matchedEvents: $steps.searchEvents.outputs.matchedEvents
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.