GlassFlow Observability

This guide explains how to export GlassFlow’s logs and metrics for monitoring and observability purposes.

Metrics are enabled by default in the Helm chart and available at the OTEL collector endpoint
Logs can be enabled by configuring an OTLP exporter endpoint
The OTEL collector service is available at {release-name}-otel-collector.{namespace}.svc.cluster.local:9090

Metrics Export

GlassFlow includes an OpenTelemetry (OTEL) collector that exposes metrics by default via a Prometheus exporter. The metrics are available at the /metrics endpoint.

Accessing Metrics

The OTEL collector service exposes metrics at:


{release-name}-otel-collector.{namespace}.svc.cluster.local:9090/metrics

For example, if you installed GlassFlow with the release name glassflow-chart in the glassflow namespace:


glassflow-chart-otel-collector.glassflow.svc.cluster.local:9090/metrics

Prometheus Scraping

To scrape metrics with Prometheus, add the following configuration to your Prometheus config:


# GlassFlow OTEL Collector metrics
- job_name: 'glassflow-otel-collector'
  static_configs:
  - targets: ['glassflow-chart-otel-collector.glassflow.svc.cluster.local:9090']
  metrics_path: /metrics
  scrape_interval: 15s

💡

Replace glassflow-chart and glassflow with your actual release name and namespace if different.

Logs Export

To enable log export, you need to configure an OTLP exporter endpoint in your Helm values.

Configure OTLP Exporter

Update your values.yaml file to include the OTLP exporter configuration under global.observability.logs:


global:
  observability:
    logs:
      enabled: true
      exporter:
        otlp/my-endpoint:
          endpoint: your-otel-endpoint.com:4317
          tls:
            insecure: true

💡

Endpoint Protocol:

For HTTP (often port 4318): Use http://your-endpoint:4318
For gRPC (often port 4317): Use your-endpoint:4317 (no http prefix)

GlassFlow sends logs to any OTLP-compatible endpoint. The exporter configuration follows the standard OpenTelemetry Collector OTLP exporter format. Refer to the OpenTelemetry Collector OTLP Exporter documentation for detailed configuration options.

For a complete list of available metrics and their labels, see the Metrics Reference.