Module Contents



Uses datadog API to send metrics of practically anything measurable,

class airflow.providers.datadog.hooks.datadog.DatadogHook(datadog_conn_id='datadog_default')[source]

Bases: airflow.hooks.base.BaseHook, airflow.utils.log.logging_mixin.LoggingMixin

Uses datadog API to send metrics of practically anything measurable, so it's possible to track # of db records inserted/deleted, records read from file and many other useful metrics.

Depends on the datadog API, which has to be deployed on the same server where Airflow runs.


datadog_conn_id (str) -- The connection to datadog, containing metadata for api keys.

validate_response(self, response)[source]

Validate Datadog response

send_metric(self, metric_name, datapoint, tags=None, type_=None, interval=None)[source]

Sends a single datapoint metric to DataDog

  • metric_name (str) -- The name of the metric

  • datapoint (Union[float, int]) -- A single integer or float related to the metric

  • tags (Optional[List[str]]) -- A list of tags associated with the metric

  • type -- Type of your metric: gauge, rate, or count

  • interval (Optional[int]) -- If the type of the metric is rate or count, define the corresponding interval

query_metric(self, query, from_seconds_ago, to_seconds_ago)[source]

Queries datadog for a specific metric, potentially with some function applied to it and returns the results.

  • query (str) -- The datadog query to execute (see datadog docs)

  • from_seconds_ago (int) -- How many seconds ago to start querying for.

  • to_seconds_ago (int) -- Up to how many seconds ago to query for.

post_event(self, title, text, aggregation_key=None, alert_type=None, date_happened=None, handle=None, priority=None, related_event_id=None, tags=None, device_name=None)[source]

Posts an event to datadog (processing finished, potentially alerts, other issues) Think about this as a means to maintain persistence of alerts, rather than alerting itself.

  • title (str) -- The title of the event

  • text (str) -- The body of the event (more information)

  • aggregation_key (Optional[str]) -- Key that can be used to aggregate this event in a stream

  • alert_type (Optional[str]) -- The alert type for the event, one of ["error", "warning", "info", "success"]

  • date_happened (Optional[int]) -- POSIX timestamp of the event; defaults to now

  • handle (Optional[str]) -- str

  • priority (Optional[str]) -- Priority to post the event as. ("normal" or "low", defaults to "normal")

  • related_event_id (Optional[int]) -- Post event as a child of the given event

  • tags (Optional[List[str]]) -- List of tags to apply to the event

  • device_name (Optional[List[str]]) -- device_name to post the event with


User to post the event as; defaults to owner of the application key used to submit.

Was this entry helpful?