DOC-4519-audit-log

[mendonk]

Add audit log streaming feature to customer documentation.
Tested and works 100%

[mlr]

Antora site build successful! ✅
Deploying draft.
Deployment successful! View draft

[aimurphy]

Please review my comments.

[aimurphy]

Looking at the API docs again, I believe the DevOps API endpoint can be used instead of contacting DataStax Support. I asked for clarification on the ticket.

If that is true, we should add this as alternative last step, like:

. Finalize the audit log streaming configuration:

<tabs for DataStax Support // Astra DevOps API>

The DataStax Support tab would have the current last step on it.
The Astra DevOps API would either link to the endpoint docs (easiest) or show the DevOps API call & response:

[source,curl,subs="verbatim,quotes"]
----
curl --request POST \
  --url 'https://api.astra.datastax.com/v2/organizations/**ORG_ID**/telemetry/auditLogs' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer **APPLICATION_TOKEN**' \
  --data '{
  "pulsar": {
    "endpoint": "pulsar+**BROKER_SERVICE_URL**",
    "auth_strategy": "token",
    "topic": "**TOPIC_FULL_NAME**",
    "auth_name": "token",
    "token": "**PULSAR_AUTHENTICATION_TOKEN**"
  }
}'
----

It might be easier to link to the docs bc the authentication data depends on the Pulsar Broker config.
Make sure to clarify that it's the Astra DevOps API, not the Astra Streaming DevOps API.

[mlr]

Antora site build successful! ✅
Deploying draft.
Deployment successful! View draft

[mlr]

Antora site build successful! ✅
Deploying draft.
Deployment successful! View draft

[mlr]

Antora site build successful! ✅
Deploying draft.
Deployment successful! View draft

[mlr]

Antora site build successful! ✅
Deploying draft.
Deployment successful! View draft

[aimurphy]

Few more comments, please consider them.

[mlr]

Antora site build failure! ❌

{"level":"error","time":1723652786454,"name":"asciidoctor","file":{"path":"modules/operations/pages/monitoring/stream-audit-logs.adoc"},"source":{"url":"https://github.com/datastax/astra-streaming-docs.git","refname":"DOC-4519-audit-log-telemetry","reftype":"branch"},"msg":"target of xref not found: astra-api-docs:ROOT:attachment$devops-api/index.html#tag/Organization-Operations/operation/configureTelemetry"} {"level":"error","time":1723652786457,"name":"asciidoctor","file":{"path":"modules/operations/pages/monitoring/stream-audit-logs.adoc"},"source":{"url":"https://github.com/datastax/astra-streaming-docs.git","refname":"DOC-4519-audit-log-telemetry","reftype":"branch"},"msg":"target of xref not found: astra-api-docs:ROOT:attachment$devops-api/index.html#tag/Organization-Operations/operation/configureTelemetry"} {"level":"error","time":1723652786459,"name":"asciidoctor","file":{"path":"modules/operations/pages/monitoring/stream-audit-logs.adoc"},"source":{"url":"https://github.com/datastax/astra-streaming-docs.git","refname":"DOC-4519-audit-log-telemetry","reftype":"branch"},"msg":"target of xref not found: astra-api-docs:ROOT:attachment$devops-api/index.html#tag/Organization-Operations/operation/deleteTelemetryConfig"} > tailwindcss > tailwindcss build -c ${npm_config_tailwind_config_path} -i ${npm_config_css_path} -o ${npm_config_css_path} --minify Browserslist: caniuse-lite is outdated. Please run: npx update-browserslist-db@latest Why you should do it regularly: https://github.com/browserslist/update-db#readme Rebuilding... Done in 7858ms.

[mlr]

Antora site build failure! ❌

{"level":"error","time":1723653068141,"name":"asciidoctor","file":{"path":"modules/operations/pages/monitoring/stream-audit-logs.adoc"},"source":{"url":"https://github.com/datastax/astra-streaming-docs.git","refname":"DOC-4519-audit-log-telemetry","reftype":"branch"},"msg":"target of xref not found: astra-api-docs:ROOT:attachment$devops-api/index.html#tag/Organization-Operations/operation/configureTelemetry"} {"level":"error","time":1723653068144,"name":"asciidoctor","file":{"path":"modules/operations/pages/monitoring/stream-audit-logs.adoc"},"source":{"url":"https://github.com/datastax/astra-streaming-docs.git","refname":"DOC-4519-audit-log-telemetry","reftype":"branch"},"msg":"target of xref not found: astra-api-docs:ROOT:attachment$devops-api/index.html#tag/Organization-Operations/operation/configureTelemetry"} {"level":"error","time":1723653068145,"name":"asciidoctor","file":{"path":"modules/operations/pages/monitoring/stream-audit-logs.adoc"},"source":{"url":"https://github.com/datastax/astra-streaming-docs.git","refname":"DOC-4519-audit-log-telemetry","reftype":"branch"},"msg":"target of xref not found: astra-api-docs:ROOT:attachment$devops-api/index.html#tag/Organization-Operations/operation/deleteTelemetryConfig"} > tailwindcss > tailwindcss build -c ${npm_config_tailwind_config_path} -i ${npm_config_css_path} -o ${npm_config_css_path} --minify Browserslist: caniuse-lite is outdated. Please run: npx update-browserslist-db@latest Why you should do it regularly: https://github.com/browserslist/update-db#readme Rebuilding... Done in 7802ms.

[aimurphy]

Those references should work, they are in prod. Maybe need to update the branch from main?

[aimurphy]

Approving so that you can merge it once the errors are fixed.
If necessary, you can use the direct links, and we will figure out the xref issue later.

https://docs.datastax.com/en/astra-api-docs/_attachments/devops-api/index.html#tag/Organization-Operations/operation/configureTelemetry

https://docs.datastax.com/en/astra-api-docs/_attachments/devops-api/index.html#tag/Organization-Operations/operation/deleteTelemetryConfig

[mlr]

Antora site build successful! ✅
Deploying draft.
Deployment successful! View draft