​

Metricsaslogs Connector

​

Overview

Deprecation Notice: The component type has been renamed from metricsaslogs to metrics_as_logs to follow the OpenTelemetry snake_case naming convention. The old name metricsaslogs still works but is deprecated and will be removed in a future release. Please update your configuration to use metrics_as_logs.

​

Current Limitations

• Metric exemplars
• Advanced metadata

​

Configuration

• include_resource_attributes (default = true): Whether to include resource attributes in the generated logs
• include_scope_info (default = true): Whether to include instrumentation scope information in the generated logs

​

Log Body Format

{"metric_name": "$NAME", "value": "$VALUE"}

• $NAME is the actual metric name
• $VALUE is the metric value (simple values for gauge/sum, complex JSON for histogram/summary)

​

Example Usage

​

Basic Configuration

connectors:
  metrics_as_logs:

service:
  pipelines:
    logs:
      receivers: [metrics_as_logs]
      processors: []
      exporters: [debug]
    metrics:
      receivers: [otlp]
      processors: []
      exporters: [metrics_as_logs]

​

Advanced Configuration

connectors:
  metrics_as_logs:
    include_resource_attributes: false
    include_scope_info: false

​

Example Metric Conversions

{
  "body": {"metric_name": "cpu_usage", "value": "85.2"},
  "attributes": {
    "metric.name": "cpu_usage",
    "metric.type": "Gauge",
    "metric.description": "CPU usage percentage",
    "metric.unit": "%"
  }
}

{
  "body": {
    "metric_name": "request_duration", 
    "value": "{\"count\":100,\"sum\":1.5,\"bucket_counts\":[10,50,40],\"explicit_bounds\":[0.1,0.5,1.0]}"
  },
  "attributes": {
    "metric.name": "request_duration",
    "metric.type": "Histogram",
    "metric.description": "Request duration in seconds",
    "metric.unit": "s",
    "metric.aggregation_temporality": "Delta"
  }
}

​

Output Structure

• Body: Fixed JSON format: {"metric_name": "$NAME", "value": "$VALUE"}
• Timestamp: Metric data point timestamp
• Observed Timestamp: Metric data point start timestamp (if available)
• Attributes:
  • Original metric data point attributes (labels)
  • metric.name: The metric name
  • metric.type: The metric type (Gauge, Sum, Histogram, etc.)
  • metric.description: Metric description (if available)
  • metric.unit: Metric unit (if available)
  • Additional type-specific attributes:
    • For Sum metrics: metric.is_monotonic, metric.aggregation_temporality
    • For Histogram/ExponentialHistogram: metric.aggregation_temporality
  • Resource attributes (if include_resource_attributes is true)
  • Instrumentation scope information (if include_scope_info is true)

​

Supported Metric Types

• Gauge: Point-in-time measurements
• Sum: Cumulative or delta measurements
• Histogram: Distribution of measurements with buckets
• Exponential Histogram: Distribution with exponentially sized buckets
• Summary: Distribution with quantile values

​

Value Encoding

• For simple metrics (Gauge, Sum): numeric value as string
• For complex metrics (Histogram, etc.): JSON-encoded object as string