メニュー
SignalDB service discovery - capability-based routing, ServiceBootstrap pattern, catalog schema, connection pooling, and heartbeat mechanism. Use when working with service registration, capability routing, or inter-service communication.
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
SignalDB Tempo API compatibility - implemented/stub endpoints, query flow, admin API, Grafana native plugin, and built-in Tempo datasource support. Use when working with HTTP API, Grafana integration, or query endpoints.
SignalDB architecture reference - FDAP stack, write/query data flow, service components, deployment models, and dual catalog system. Use when understanding how components fit together, data flow, or system design.
SignalDB crate map - workspace members, module locations within common/writer/querier/router crates, and key root files. Use when navigating the codebase, finding where code lives, or understanding module boundaries.
SignalDB multi-tenancy and authentication - tenant model, auth flow, isolation layers, slug-based naming, API keys, admin API, and CLI. Use when working with tenant isolation, authentication, API keys, or dataset management.
SignalDB configuration reference - all TOML sections, environment variables, database/discovery/storage/WAL/schema/auth/queue settings, and service ports. Use when working with configuration, environment variables, or TOML settings.
Step-by-step guide for adding a new signal type or table to SignalDB - schema definition, Flight schema, OTLP conversion, WAL operation, acceptor/writer/querier/router updates, and testing. Use when adding new signal types, metric types, or tables.
| name | service-discovery |
| description | SignalDB service discovery - capability-based routing, ServiceBootstrap pattern, catalog schema, connection pooling, and heartbeat mechanism. Use when working with service registration, capability routing, or inter-service communication. |
| user-invocable | false |
| sources | ["docs/architecture/service-discovery.md","src/common/src/catalog.rs","src/common/src/service_bootstrap.rs","src/common/src/flight/transport.rs"] |
Services register with specific capabilities for automatic routing:
| Service | Capabilities | Discovery Pattern |
|---|---|---|
| Acceptor | TraceIngestion | Clients connect directly via OTLP |
| Writer | TraceIngestion, Storage | Acceptors discover via Storage capability |
| Router | Routing | Clients connect directly via HTTP |
| Querier | QueryExecution | Routers discover via QueryExecution capability |
| Compactor | StorageMaintenance | Registers for compaction/cleanup coordination |
ServiceCapability has 6 variants (src/common/src/flight/transport.rs):
TraceIngestion, QueryExecution, Routing, Storage, KafkaIngestion,
StorageMaintenance.
Every service uses ServiceBootstrap at startup:
[discovery] or [database] DSN)service_idingesters table with service_type, address, capabilities (comma-separated)last_seen// Registers in the catalog and starts the heartbeat task
let bootstrap =
ServiceBootstrap::new(config, ServiceType::Writer, "0.0.0.0:50061".to_string()).await?;
// ... service runs ...
// bootstrap.shutdown().await? deregisters gracefully; Drop also deregisters
CREATE TABLE ingesters (
id UUID PRIMARY KEY,
address TEXT NOT NULL,
last_seen TIMESTAMP WITH TIME ZONE,
service_type TEXT NOT NULL DEFAULT 'Writer',
capabilities TEXT NOT NULL DEFAULT 'TraceIngestion,Storage'
);
AtomicUsize counter with fetch_add in transport.rs)[database]
dsn = "sqlite://.data/signaldb.db"
[discovery]
dsn = "sqlite://.data/signaldb.db" # Falls back to [database].dsn
heartbeat_interval = "30s"
poll_interval = "60s"
ttl = "300s"
| File | Purpose |
|---|---|
src/common/src/catalog.rs | Catalog trait + implementations |
src/common/src/service_bootstrap.rs | ServiceBootstrap registration |
src/common/src/flight/transport.rs | InMemoryFlightTransport, connection pooling |
src/router/src/discovery.rs | Router's cached service registry |