[HTTP/OAS] Add operation tags for APM APIs

[lcawl]

Summary

Relates to #180056

This PR adds tags for the APM agent key and annotation APIs in the manually-maintained and automatically-generated API documents.

NOTE: I used "APM annotations" and "APM agent keys" as the tags to align with https://www.elastic.co/guide/en/kibana/current/apm-annotation-api.html and https://www.elastic.co/guide/en/kibana/current/agent-key-api.html, but if you prefer to group them all under a tag called "APM" that's okay too.

How to test

Per #181277:

1. Start Elasticsearch (e.g. yarn es snapshot --license trial)
2. Add server.oas.enabled: true to kibana.dev.yml
3. Start Kibana (e.g. yarn start --no-base-path)
4. curl -s -u elastic http://localhost:5601/api/oas\?pathStartsWith\=/api/apm | jq > test.json

    "paths": {
    "/api/apm/agent_keys": {
      "post": {
        "summary": "",
        "tags": [
          "APM agent keys"
        ]

...
    "/api/apm/services/{serviceName}/annotation/search": {
      "get": {
        "summary": "",
        "tags": [
          "APM annotations"
        ],

[apmmachine]

🤖 GitHub comments

Expand to view the GitHub comments

Just comment with:

• /oblt-deploy : Deploy a Kibana instance using the Observability test environments.
• /oblt-deploy-serverless : Deploy a serverless Kibana instance using the Observability test environments.
• run elasticsearch-ci/docs : Re-trigger the docs validation. (use unformatted text in the comment!)

[elasticmachine]

Pinging @elastic/obs-ux-infra_services-team (Team:obs-ux-infra_services)

[kibana-ci]

💛 Build succeeded, but was flaky

• Buildkite Build
• Commit: e3cb3fe
• Kibana Serverless Image: docker.elastic.co/kibana-ci/kibana-serverless:pr-181353-e3cb3fed1f61
• Observability Deployment

Failed CI Steps

Metrics [docs]

✅ unchanged

History

To update your PR or re-run it, just comment with:
@elasticmachine merge upstream