feat(obs): add advanced log management configuration (#2016)

Co-authored-by: houseme <housemecn@gmail.com> Co-authored-by: 安正超 <anzhengchao@gmail.com> Co-authored-by: 唐小鸭 <tangtang1251@qq.com>
2026-08-30 00:47:13 +00:00 · 2026-03-01 03:23:48 +08:00
parent e7466eb1cc
commit 2c01b8c49d
26 changed files with 2560 additions and 1305 deletions
@@ -0,0 +1,64 @@
+// Copyright 2024 RustFS Team
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+//! OpenTelemetry [`Resource`] construction for RustFS.
+//!
+//! A `Resource` describes the entity producing telemetry data.  The resource
+//! built here includes the service name, service version, deployment
+//! environment, and the local machine IP address so that data can be
+//! correlated across services in a distributed system.
+
+use crate::config::OtelConfig;
+use opentelemetry::KeyValue;
+use opentelemetry_sdk::Resource;
+use opentelemetry_semantic_conventions::{
+    SCHEMA_URL,
+    attribute::{DEPLOYMENT_ENVIRONMENT_NAME, NETWORK_LOCAL_ADDRESS, SERVICE_VERSION as OTEL_SERVICE_VERSION},
+};
+use rustfs_config::{APP_NAME, ENVIRONMENT, SERVICE_VERSION};
+use rustfs_utils::get_local_ip_with_default;
+use std::borrow::Cow;
+
+/// Build an OpenTelemetry [`Resource`] populated from the provided config.
+///
+/// The resource carries the following attributes:
+/// - `service.name` — from `config.service_name`, defaulting to [`APP_NAME`].
+/// - `service.version` — from `config.service_version`, defaulting to
+///   [`SERVICE_VERSION`].
+/// - `deployment.environment` — from `config.environment`, defaulting to
+///   [`ENVIRONMENT`].
+/// - `network.local.address` — the primary local IP of the current host,
+///   useful for identifying individual nodes in a cluster.
+///
+/// All attributes are attached to the resource using the semantic conventions
+/// schema URL to ensure compatibility with standard OTLP backends.
+pub(super) fn build_resource(config: &OtelConfig) -> Resource {
+    Resource::builder()
+        .with_service_name(Cow::Borrowed(config.service_name.as_deref().unwrap_or(APP_NAME)).to_string())
+        .with_schema_url(
+            [
+                KeyValue::new(
+                    OTEL_SERVICE_VERSION,
+                    Cow::Borrowed(config.service_version.as_deref().unwrap_or(SERVICE_VERSION)).to_string(),
+                ),
+                KeyValue::new(
+                    DEPLOYMENT_ENVIRONMENT_NAME,
+                    Cow::Borrowed(config.environment.as_deref().unwrap_or(ENVIRONMENT)).to_string(),
+                ),
+                KeyValue::new(NETWORK_LOCAL_ADDRESS, get_local_ip_with_default()),
+            ],
+            SCHEMA_URL,
+        )
+        .build()
+}