Skip to content

[AGNTLOG-229 Multiline features FAQ #29931

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

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open

Conversation

DDuongNguyen
Copy link
Contributor

What does this PR do? What is the motivation?

This PR adds a user-friendly FAQ section to the multi-line log aggregation documentation to help users better understand when and how to use different multi-line aggregation approaches.

The motivation is to reduce confusion and help users choose the right multi-line aggregation approach for their specific needs.

Merge instructions

Merge readiness:

  • [] Ready for merge

Additional notes

This is a documentation-only change that improves clarity without modifying any functionality.

@DDuongNguyen DDuongNguyen changed the title first draft of multiline features faq Multiline features FAQ Jun 12, 2025
Copy link
Contributor

github-actions bot commented Jun 12, 2025

📝 Documentation Team Review Required

This pull request requires approval from the @DataDog/documentation team before it can be merged.

Please ensure your changes follow our documentation guidelines and wait for a team member to review and approve your changes.

Copy link
Contributor

@DDuongNguyen DDuongNguyen changed the title Multiline features FAQ [AGNTLOG-229 Multiline features FAQ Jun 12, 2025
@jszwedko jszwedko marked this pull request as ready for review June 16, 2025 18:56
@jszwedko jszwedko requested a review from a team as a code owner June 16, 2025 18:56
@urseberry urseberry self-assigned this Jun 16, 2025
Comment on lines +636 to +637
If you know the format of your logs, you should use manual multi-line rules for more precise control.
If you are sending lots of multi-line logs and you are unsure of their format or don't have the means to configure all sources individually, you should use automatic multi-line detection.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
If you know the format of your logs, you should use manual multi-line rules for more precise control.
If you are sending lots of multi-line logs and you are unsure of their format or don't have the means to configure all sources individually, you should use automatic multi-line detection.
If you know the format of your logs, you should use manual multi-line rules for precise control.
If you are sending lots of multi-line logs, and you are unsure of their format or don't have the means to configure all sources individually, you should use automatic multi-line detection.

Comment on lines +641 to +642
All non-JSON log lines will be processed individually as separate log entries.
All JSON-formatted log lines will be treated as a single line of logs, and only the first valid JSON format will enter the intake; the rest will be dropped.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
All non-JSON log lines will be processed individually as separate log entries.
All JSON-formatted log lines will be treated as a single line of logs, and only the first valid JSON format will enter the intake; the rest will be dropped.
All non-JSON log lines are processed individually as separate log entries.
All JSON-formatted log lines are treated as a single line of logs, and only the first valid JSON format enters the intake; the rest are dropped.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants