add changelog

Author: lalitb

opentelemetry-sdk/CHANGELOG.md

@@ -5,6 +5,19 @@
 - Add "metrics", "logs" to default features. With this, default feature list is
   "trace", "metrics" and "logs".
 
+- **Breaking** [1726](https://github.com/open-telemetry/opentelemetry-rust/pull/1726)
+  Update `LogProcessor::emit() method to take mutable reference to LogData. This is breaking
+  change for LogProcessor developers. If the processor needs to invoke the exporter 
+  asynchronously, it should clone the data to ensure it can be safely processed without 
+  lifetime issues. Any changes made to the log data in this method will be reflected in 
+  the next log processor in the chain, as well as to the exporter.
+
+- **Breaking** [1726](https://github.com/open-telemetry/opentelemetry-rust/pull/1726)
+ Update `LogExporter::export() method to accepts a batch of log data, which can be either a 
+ reference or owned `LogData`. If the exporter needs to process the log data
+ asynchronously, it should clone the log data to ensure it can be safely processed without 
+ lifetime issues. 
+
 ## v0.23.0
 
 - Fix SimpleSpanProcessor to be consistent with log counterpart. Also removed

opentelemetry-sdk/benches/log.rs

@@ -1,3 +1,8 @@
+//! run with `$ cargo bench --bench log --features=logs -- --exact <test_name>` to run specific test for logs
+//! So to run test named "full-log-with-attributes/with-context" you would run `$ cargo bench --bench log --features=logs -- --exact full-log-with-attributes/with-context`
+//! To run all tests for logs you would run `$ cargo bench --bench log --features=logs`
+//!
+
 use std::collections::HashMap;
 use std::time::SystemTime;
 

opentelemetry-sdk/src/logs/log_processor.rs

@@ -46,6 +46,15 @@ const OTEL_BLRP_MAX_EXPORT_BATCH_SIZE_DEFAULT: usize = 512;
 /// [`Logger`]: crate::logs::Logger
 pub trait LogProcessor: Send + Sync + Debug {
     /// Called when a log record is ready to processed and exported.
+    ///
+    /// This method receives a mutable reference to `LogData`. If the processor
+    /// needs to handle the export asynchronously, it should clone the data to
+    /// ensure it can be safely processed without lifetime issues. Any changes
+    /// made to the log data in this method will be reflected in the next log
+    /// processor in the chain.
+    ///
+    /// # Parameters
+    /// - `data`: A mutable reference to `LogData` representing the log record.
     fn emit(&self, data: &mut LogData);
     /// Force the logs lying in the cache to be exported.
     fn force_flush(&self) -> LogResult<()>;