Skip to content

docs(logs): clarify setTimestamp javadoc for event timestamp behavior #8104

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.

Sign up for GitHub

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
jack-berg merged 4 commits into from
Mar 3, 2026
Merged

docs(logs): clarify setTimestamp javadoc for event timestamp behavior #8104

Changes from 1 commit
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
317aa33
docs(logs): clarify setTimestamp javadoc for event timestamp behavior
ruturajjadhav07 Feb 19, 2026
5b0b36a
Update api/all/src/main/java/io/opentelemetry/api/logs/LogRecordBuild…
ruturajjadhav07 Feb 20, 2026
a2b4134
docs(logs): simplify setTimestamp javadoc note
ruturajjadhav07 Feb 21, 2026
794d6ea
spotless
jack-berg Mar 3, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions api/all/src/main/java/io/opentelemetry/api/logs/LogRecordBuilder.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -31,16 +31,16 @@ public interface LogRecordBuilder {
/**
* Set the epoch {@code timestamp}, using the timestamp and unit.
*
* <p>The {@code timestamp} is the time at which the log record occurred. If unset, it will be set
* to the current time when {@link #emit()} is called.
* <p>Note: If the event timestamp is unset, it will NOT be automatically populated when
* {@link #emit()} is called. Only the observed timestamp receives a default value.
Comment thread
ruturajjadhav07 marked this conversation as resolved.
Outdated
*/
LogRecordBuilder setTimestamp(long timestamp, TimeUnit unit);

/**
* Set the epoch {@code timestamp}, using the instant.
*
* <p>The {@code timestamp} is the time at which the log record occurred. If unset, it will be set
* to the current time when {@link #emit()} is called.
* <p>Note: If the event timestamp is unset, it will NOT be automatically populated when
* {@link #emit()} is called. Only the observed timestamp receives a default value.
Copy link
Copy Markdown
Member

@jack-berg jack-berg Feb 20, 2026

Choose a reason for hiding this comment

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

Please apply the note change here as well

Copy link
Copy Markdown
Contributor Author

@ruturajjadhav07 ruturajjadhav07 Feb 21, 2026

Choose a reason for hiding this comment

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

Please apply the note change here as well

Updated as suggested. Thank you!

*/
LogRecordBuilder setTimestamp(Instant instant);

Expand Down
Loading