diff --git a/api/all/src/main/java/io/opentelemetry/api/logs/LogRecordBuilder.java b/api/all/src/main/java/io/opentelemetry/api/logs/LogRecordBuilder.java index c0239724b36..2c264fd18df 100644 --- a/api/all/src/main/java/io/opentelemetry/api/logs/LogRecordBuilder.java +++ b/api/all/src/main/java/io/opentelemetry/api/logs/LogRecordBuilder.java @@ -31,16 +31,22 @@ public interface LogRecordBuilder { /** * Set the epoch {@code timestamp}, using the timestamp and unit. * - *
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. + *
The {@code timestamp} is the time at which the log record occurred. If unset, the timestamp + * will remain unset. + * + *
The observed timestamp will be set to the current time when {@link #emit()} is called if it + * is not explicitly set. */ LogRecordBuilder setTimestamp(long timestamp, TimeUnit unit); /** - * Set the epoch {@code timestamp}, using the instant. + * Set the epoch {@code timestamp}, using the timestamp and unit. + * + *
The {@code timestamp} is the time at which the log record occurred. If unset, the timestamp + * will remain unset. * - *
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. + *
The observed timestamp will be set to the current time when {@link #emit()} is called if it + * is not explicitly set. */ LogRecordBuilder setTimestamp(Instant instant);