Skip to content

Cloud SIEM custom detection rules Cdocsification#35279

Open
janine-c wants to merge 6 commits intomasterfrom
janine/docs-13607-siem-detection-rule-creation-cdocs
Open

Cloud SIEM custom detection rules Cdocsification#35279
janine-c wants to merge 6 commits intomasterfrom
janine/docs-13607-siem-detection-rule-creation-cdocs

Conversation

@janine-c
Copy link
Contributor

What does this PR do? What is the motivation?

Converts the Cloud SIEM page about creating custom detection rules into Cdocs!

Merge instructions

Merge readiness:

  • Ready for merge

For Datadog employees:

Your branch name MUST follow the <name>/<description> convention and include the forward slash (/). Without this format, your pull request will not pass CI, the GitLab pipeline will not run, and you won't get a branch preview. Getting a branch preview makes it easier for us to check any issues with your PR, such as broken links.

If your branch doesn't follow this format, rename it or create a new branch and PR.

[6/5/2025] Merge queue has been disabled on the documentation repo. If you have write access to the repo, the PR has been reviewed by a Documentation team member, and all of the required checks have passed, you can use the Squash and Merge button to merge the PR. If you don't have write access, or you need help, reach out in the #documentation channel in Slack.

AI assistance

Additional notes

@janine-c janine-c requested review from a team as code owners March 13, 2026 18:18
@janine-c janine-c added the WORK IN PROGRESS No review needed, it's a wip ;) label Mar 13, 2026
@github-actions github-actions bot added Architecture Everything related to the Doc backend Images Images are added/removed with this PR cdocs labels Mar 13, 2026
@janine-c janine-c changed the title Janine/docs 13607 siem detection rule creation cdocs Cloud SIEM custom detection rules Cdocsification Mar 13, 2026
@github-actions
Copy link
Contributor

Copy link

@chatgpt-codex-connector chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 43de641f0e

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

Comment on lines +32 to +36
1. {% if equals($cloud_siem_detection_rule_type, "real_time_rule") %}Select **Real-Time Rule**.{% /if %}
{% if equals($cloud_siem_detection_rule_type, "scheduled_rule") %}Select **Scheduled Rule**.{% /if %}
{% if equals($cloud_siem_detection_rule_type, "historical_job") %}Select **Historical job**, then select the **Logs Index** and **Timerange** for the job.{% /if %}
1. {% if equals($cloud_siem_detection_rule_search_query, "threshold") %}Select the **Threshold** detection method.{% /if %}
{% if equals($cloud_siem_detection_rule_search_query, "new_value") %}Select the **New value** detection method.{% /if %}

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Move ordered-list markers into each conditional step

The numbered steps in "Create a rule" place 1. outside the {% if ... %} blocks, so non-default variants render an empty list item followed by plain text instead of a proper numbered step (for example, scheduled_rule and any search query other than threshold). This breaks the procedural flow for most filter combinations and makes the instructions harder to follow.

Useful? React with 👍 / 👎.

- These parameters help to identify field content that is both unusual and rare, filtering out minor or common variations.
- See [Anomaly detection parameters][601] for more information.

[601]: /security/cloud_siem/detect_and_monitor/custom_detection_rules/content_anomaly/#anomaly-detection-parameters No newline at end of file

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Avoid reusing markdown reference id 601 across partials

This partial defines link reference [601], but unit_testing.mdoc.md also defines [601] to a different URL and both partials are included in the content-anomaly render paths of create_rule/_index.mdoc.md. Because markdown reference labels are document-scoped, this collision makes at least one of the links resolve to the wrong destination depending on parser behavior.

Useful? React with 👍 / 👎.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Architecture Everything related to the Doc backend cdocs Images Images are added/removed with this PR WORK IN PROGRESS No review needed, it's a wip ;)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant