Skip to content

[DOCS-10886] Add OP Custom Processor #29565

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 10 commits into from
Jun 4, 2025
Merged

Conversation

maycmlee
Copy link
Contributor

@maycmlee maycmlee commented May 27, 2025

What does this PR do? What is the motivation?

Add OP Custom Processor docs.

For docs review, just need the following:

Thanks!

Merge instructions

Merge readiness:

  • Ready for merge

For Datadog employees:
Merge queue is enabled in this repo. Your branch name MUST follow the <name>/<description> convention and include the forward slash (/). Without this format, your pull request will not pass in 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.

To have your PR automatically merged after it receives the required reviews, add the following PR comment:

/merge

Additional notes

@maycmlee maycmlee requested a review from a team as a code owner May 27, 2025 19:35
@maycmlee maycmlee added the WORK IN PROGRESS No review needed, it's a wip ;) label May 27, 2025
@github-actions github-actions bot added the Architecture Everything related to the Doc backend label May 27, 2025
@maycmlee maycmlee added the okr11 label May 27, 2025
Copy link
Contributor

github-actions bot commented May 27, 2025

Preview links (active after the build_preview check completes)

New or renamed files

Modified Files

@maycmlee maycmlee removed the WORK IN PROGRESS No review needed, it's a wip ;) label May 28, 2025
Copy link
Contributor

github-actions bot commented May 28, 2025

✅ Documentation Team Review

The documentation team has approved this pull request. Thank you for your contribution!

@drichards-87
Copy link
Contributor

Created DOCS-11049 for Docs Team review.

@drichards-87 drichards-87 added the editorial review Waiting on a more in-depth review label May 28, 2025
Copy link
Contributor

@aliciascott aliciascott left a comment

Choose a reason for hiding this comment

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

Hi @maycmlee this looks good! Thanks for being specific on what needs reviewed since that shortcode is used throughout it made it a lot easier :)


To set up this processor:

Click **Manage custom processors**.
Copy link

@mikhacim mikhacim Jun 3, 2025

Choose a reason for hiding this comment

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

Should be: Add custom processor
Manage is for when you've already created processors prior. The first creation flow is clicking Add custom processor and going to step 1 on line 24

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Ah okay thanks. Removing this line and updating the two bullet points below.


##### Add a function

1. Enter a name for the function.
Copy link

Choose a reason for hiding this comment

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

Enter a name for your custom processor

Copy link
Contributor Author

Choose a reason for hiding this comment

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

updated

##### Add a function

1. Enter a name for the function.
1. Add your script to modify your logs using [custom functions][10191].
Copy link

Choose a reason for hiding this comment

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

Can we add a section for using Library Functions?
"Select a Library Function to get started with example functions for popular use cases. Refer to this guide (link the guide we're creating) for more information."

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Updated. I said to "click Autofill with Example" instead of "Select a Library Function" because we don't mention anything about library function in the UI. I'll add a link to the guide once the guide is live.

1. Add your script to modify your logs using [custom functions][10191].
1. Optionally, check **Drop events on error** if you want to drop events that encounter an error during processing.
1. Enter a sample log event.
1. Click **Run** to process the log and see the output.
Copy link

Choose a reason for hiding this comment

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

Click Run to preview how the functions will process the log. Once executed, you are able to see the expected output for the log.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

updated

@maycmlee maycmlee merged commit 3ceab62 into master Jun 4, 2025
17 checks passed
@maycmlee maycmlee deleted the may/op-custom-processing branch June 4, 2025 17:55
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 editorial review Waiting on a more in-depth review okr11
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants