Migrate from Events API v1 to Events API v2
Events API v1 has been deprecated with Dynatrace version 1.243. Its replacement is Events API v2. We recommend that you migrate to the new API at your earliest convenience.
The migration affects endpoint URLs, query parameters, and response/request body parameters, as well as the scope of the token for request authentication.
New features
Events API v2 offers you the following new features:
- The entity selector helps you to filter events in read requests and ingest events that affect multiple entities.
Improved event filtering via an event selector.
Unified timeframe selector.
Event properties endpoints.
Event types endpoints.
Licensing
The ingestion of custom events consumes Davis Data Units (DDUs) from the events pool.
Base URL
| new Events v2 | old Events v1 |
|---|---|
/api/v2/events | /api/v1/events |
Authentication token scope
| new Events v2 | old Events v1 |
|---|---|
Read events (events.read)Ingest events ( events.ingest) | Access problem and event feed, metrics, and topology (DataExport) |
Parameters
To learn about new query/body parameters, see the documentation of individual requests in Events API v2.
Examples
Here are some examples of differences in API usage.
List events within a timeframe
In this example, we query a list of open availability events on hosts that happened within the last two hours.
Ingest a third-party event
In this example, we ingest a custom info event affecting all hosts whose hostname begins with prod.