Compozy Symbol
ALPHA
DocsInstallGetting StartedFeaturesPricing
CoreCLI ReferenceSchema DefinitionAPI Reference
Configuration

Monitoring

Configure Prometheus-compatible monitoring and metrics collection for your Compozy applications

Overview

1

Enable Monitoring

Add monitoring configuration to your compozy.yaml

2

Configure Path

Set a custom metrics endpoint path (optional)

3

Access Metrics

Query the metrics endpoint or integrate with Prometheus

Configuration Methods

Project Configuration

Configure monitoring in your compozy.yaml file
# compozy.yaml
name: my-app
version: 1.0.0

# Enable monitoring with custom path
monitoring:
  enabled: true
  path: /metrics  # Optional: defaults to /metrics

workflows:
  - source: ./workflow.yaml

Configuration Reference

Usage Patterns

Basic Setup

Enable with defaults

Custom Path

Use internal path

Environment Override

Configure via env vars

Accessing Metrics

Using cURL

Query metrics from the command line
# Default endpoint
curl http://localhost:8080/metrics

# Custom endpoint
curl http://localhost:8080/internal/metrics

# Pretty print with jq
curl -s http://localhost:8080/metrics | grep compozy_

Integration Guide

Troubleshooting

Monitoring & Metrics
Advanced monitoring with OpenTelemetry and custom metrics
Global Configuration
Main project configuration options and system settings
Runtime Configuration
Configure tool execution environment and settings

CLI Overview

The Compozy CLI is your primary interface for managing AI workflow orchestration, providing intuitive commands for project management, workflow execution, and system control

Overview

Compozy's YAML template engine enables dynamic configuration by combining standard YAML syntax with Go template expressions. This allows you to create flexible, reusable configurations that adapt to different contexts and data sources.