When your mission-critical workflows span days, weeks, or even months, every observability data point counts. That’s why we’re excited to announce the integration between ClickStack and Temporal Cloud’s OpenMetrics endpoint, bringing high-performance observability to your Durable Execution platform.
What is Temporal?#
Temporal is a Durable Execution platform that helps developers build reliable applications. It lets you focus on business logic rather than writing complex error handling, retry logic, and state management code to survive failures.
Your business logic runs as a Temporal Workflow, whether that means processing payments, orchestrating agents, or managing long-running shopping cart experiences. If a server crashes, the network fails, or a service goes down, Temporal automatically recovers and resumes execution exactly where it left off. No lost progress, no orphaned processes.
What is ClickStack?#
ClickStack is a cloud-native observability stack built on ClickHouse for high-performance storage and querying of logs, metrics, and traces. It’s designed for teams dealing with large volumes of telemetry and high-cardinality data, where traditional observability platforms either fall over or become cost-prohibitive.
ClickStack focuses on horizontal scalability, efficient compression, and predictable query performance, even as data volumes grow into the petabyte range. It’s commonly used for log analytics, operational monitoring, and deep investigation of production systems where ingestion rate and retention really matter.
ClickStack consists of:
- HyperDX UI, a purpose-built frontend for exploring and visualizing observability data
- A custom-built OpenTelemetry Collector, with an opinionated schema for logs, metrics, and traces
- ClickHouse, the high-performance analytical database at the core of the stack
Why ClickStack and Temporal Cloud belong together#
Running Temporal at scale means managing potentially thousands of concurrent Workflows, each with its own Activities, timers, and state transitions. When something goes wrong, or when you need to optimize performance, you need to be able to navigate the wealth of observability data coming out of the system.
This is where ClickStack helps. Built on ClickHouse, ClickStack handles the high-cardinality metrics that Temporal generates with ease, processing queries across Task Queues, Workflow Types, and Namespaces in milliseconds so you can find the needle in the haystack quickly.
For teams already running ClickStack, adding Temporal metrics means unified observability. You can see how database health affects Task processing backlogs, track how deployment changes affect Workflow latency, and build dashboards that show the complete picture of your system’s health.
Getting started: Connecting Temporal Cloud to ClickStack#
The integration uses the OpenTelemetry Collector’s Prometheus receiver to scrape metrics from Temporal Cloud. Full instructions on how to set up the integration are available, but here’s the gist: once you have a Temporal Cloud API Key with permission to read metrics, create a configuration file in the OpenTelemetry Collector like this:
receivers:
prometheus/temporal:
config:
scrape_configs:
- job_name: 'temporal-cloud'
scrape_interval: 60s
scheme: https
authorization:
type: Bearer
credentials_file: <TEMPORAL CLOUD API KEY PATH>
static_configs:
- targets: ['metrics.temporal.io']
metrics_path: '/v1/metrics'
processors:
resource:
attributes:
- key: service.name
value: "temporal"
action: upsert
service:
pipelines:
metrics/temporal:
receivers: [prometheus/temporal]
processors: [resource, memory_limiter, batch]
exporters: [clickhouse]Once deployed, open HyperDX and navigate to the Chart Explorer. Search for metrics starting with temporal_cloud to confirm data is flowing. You can import the pre-built Temporal dashboard to immediately visualize Workflow success rates, Actions consumption against your limits, and Task Queue backlogs.
What’s next#
With Temporal metrics flowing into ClickStack, you can set up alerts on critical thresholds, build custom dashboards for your specific Workflow patterns, and correlate Workflow performance with the rest of your observability data.
For full configuration details and troubleshooting guidance, check out the complete documentation.
Your durable Workflows deserve scalable observability. With ClickStack and Temporal Cloud working together, you get both.