- Which
Chargeworkflows failed in the last hour, and why? - Are any workflows stuck retrying?
- Did failures start before or after the 14:00 deploy?
- Are any workers polling the
orderstask queue? - What’s filling the
emailtask queue’s backlog?
What we support
Nexus reads workflows, their event histories and pending activities, and task queues. It never starts, signals, cancels, or terminates a workflow. It doesn’t read payloads: workflow inputs and results, signal arguments, and memos stay in Temporal. It does read failure messages and search attributes. Temporal Cloud limits each namespace’s visibility calls, and your own tools share that limit. Nexus stays well below it. This data source doesn’t read metrics. If you export Temporal’s SDK or Cloud metrics to a data source such as Prometheus or Datadog, connect that too, so Nexus can see trends such as task latency across all your workflows.Connecting Temporal
Add a telemetry data source in Nexus, choose Temporal, enter a login and the namespaces to connect, and test the connection. Each namespace becomes its own data source. Use an API key if you can, because you can limit it to read access. A client certificate can’t be limited: it has full access to every namespace that trusts its CA.Temporal Cloud
API key
- Create a service account with Read on each namespace to connect.
- Create an API key for it, and paste it in.
- Choose Find namespaces, and pick the ones to connect.
Client certificate
- Issue a client certificate from a CA your namespaces trust. See Temporal’s certificate guide.
- Paste the PEM-encoded certificate and its private key.
- Enter each namespace’s full name, such as
payments.a2b3c. Temporal Cloud can’t list namespaces for a certificate.
Self-hosted
- If the frontend isn’t reachable from the internet, choose Private network and attach a proxy.
- Enter the frontend address, such as
temporal-frontend.internal:7233. The frontend must use TLS. - Paste a client certificate and its private key, issued by a CA the frontend trusts. See Temporal’s mTLS guide. Add a CA certificate if the cluster’s server certificate uses a private CA.
- Choose Find namespaces, and pick the ones to connect.
Troubleshooting
- Temporal refused the API key. A namespace that also accepts client certificates refuses API keys on its own endpoint. Turn on These namespaces also accept client certificates, and enter your region’s endpoint, such as
europe-west3.gcp.api.temporal.io:7233. Connect each region as a separate data source. - The API key can’t read a namespace. Give its service account Read on that namespace.
- Temporal refused the client certificate. Check that the namespace trusts the certificate’s CA, and that the namespace’s certificate filters match the certificate.
- No namespace by that name. Use the full name, including the account ID, such as
payments.a2b3c. - Couldn’t reach Temporal. Check the host and port. Temporal Cloud uses port 7233. For a cluster on a private network, attach a proxy.
Related
How telemetry works
How Nexus learns and queries your namespaces.
Proxy
Reach a self-hosted cluster on a private network.