Skip to content

Documentation for pagerduty watcher action needs updating re PagerDuty Events API v2 #90799

@sparrowt

Description

@sparrowt

Elasticsearch Version

7.17.1

Installed Plugins

No response

Java Version

bundled

OS Version

Cloud hosted linux but N/A as bug is documentation only

Problem Description

The documentation for the "Watcher PagerDuty action" says:

The service must use the API integration.

However on PagerDuty there is no longer any integration called simply "API", but rather various including "Events API v1" and "Events API v2".

It took me a long time to figure out which one was actually being used, especially because many of the attributes for the pagerduty watcher action have names which still match the PagerDuty Events API v1 (which Elastic originally used) even though Elastic now translates these and uses the PagerDuty Events API v2 behind the scenes (since #32285).

Steps to Reproduce

Visit the documentation here and try to follow it:
https://www.elastic.co/guide/en/elasticsearch/reference/master/actions-pagerduty.html

We should update the content, and also ideally backport that to e.g:
https://www.elastic.co/guide/en/elasticsearch/reference/8.4/actions-pagerduty.html
https://www.elastic.co/guide/en/elasticsearch/reference/7.17/actions-pagerduty.html

Logs (if relevant)

No response

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions