This library provides an integration with Datadog, to support publishing metrics to Datadog from within Dagster ops.
We use the Python datadogpy library. To use it, you’ll first need to create a DataDog account and get both API and Application keys.
The integration uses DogStatsD, so you’ll need to ensure the datadog agent is running on the host you’re sending metrics from.
Datadog API key
Datadog application key
This resource is a thin wrapper over the dogstatsd library.
As such, we directly mirror the public API methods of DogStatsd here; you can refer to the DataDog documentation for how to use this resource.
Examples
@op(required_resource_keys={'datadog'})
def datadog_op(context):
dd = context.resources.datadog
dd.event('Man down!', 'This server needs assistance.')
dd.gauge('users.online', 1001, tags=["protocol:http"])
dd.increment('page.views')
dd.decrement('page.views')
dd.histogram('album.photo.count', 26, tags=["gender:female"])
dd.distribution('album.photo.count', 26, tags=["color:blue"])
dd.set('visitors.uniques', 999, tags=["browser:ie"])
dd.service_check('svc.check_name', dd.WARNING)
dd.timing("query.response.time", 1234)
# Use timed decorator
@dd.timed('run_fn')
def run_fn():
pass
run_fn()
@job(resource_defs={'datadog': datadog_resource})
def dd_job():
datadog_op()
result = dd_job.execute_in_process(
run_config={'resources': {'datadog': {'config': {'api_key': 'YOUR_KEY', 'app_key': 'YOUR_KEY'}}}}
)