Skip to content

:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.

3.3 KB
Raw Blame
use std::net::SocketAddr;

use common_continuous_profiling::ContinuousProfilingConfig;
use envconfig::Envconfig;

use crate::core::config::ResolverConfig;

/// Top-level config for resolution mode. Owns the shared resolver config and the
/// resolution service settings — no processing-only knobs. `INTERNAL_API_SECRET`
/// and `SYMBOL_RESOLUTION_CONCURRENCY` come from the nested `resolver`.
#[derive(Envconfig, Clone)]
pub struct ResolutionConfig {
    #[envconfig(nested = true)]
    pub resolver: ResolverConfig,

    #[envconfig(nested = true)]
    pub service: Config,

    #[envconfig(nested = true)]
    pub continuous_profiling: ContinuousProfilingConfig,

    pub posthog_api_key: Option<String>,

    #[envconfig(default = "https://us.i.posthog.com/capture")]
    pub posthog_endpoint: String,
}

impl ResolutionConfig {
    pub fn init_with_defaults() -> Result<Self, envconfig::Error> {
        Self::init_from_env()
    }
}

/// Resolution service settings (gRPC bind, metrics, concurrency, subscribe
/// cadence). Nested into [`ResolutionConfig`].
#[derive(Envconfig, Clone)]
pub struct Config {
    /// gRPC bind address for the cymbal.resolution.v1 server.
    #[envconfig(from = "GRPC_ADDRESS", default = "0.0.0.0:50061")]
    pub grpc_address: SocketAddr,

    /// HTTP bind port for liveness, readiness, and Prometheus metrics.
    #[envconfig(from = "METRICS_PORT", default = "9101")]
    pub metrics_port: u16,

    /// Cap on concurrent gRPC requests accepted by the server before fast
    /// load shedding kicks in. Beyond this, callers receive `UNAVAILABLE`
    /// and retry against another pod — preferred over hidden queue growth
    /// on the symbol-resolution semaphore. Zero disables the limit; the
    /// non-zero default keeps fail-fast semantics by default.
    #[envconfig(from = "MAX_CONCURRENT_REQUESTS", default = "256")]
    pub max_concurrent_requests: usize,

    /// Process-wide cap on concurrent item (exception) processing across all
    /// in-flight `Resolve` requests. Symbol work is governed separately by the
    /// shared `SYMBOL_RESOLUTION_CONCURRENCY` knob on the parent config.
    #[envconfig(from = "MAX_ITEM_CONCURRENCY", default = "64")]
    pub max_item_concurrency: usize,

    /// Service instance identifier surfaced to callers via `LoadEvent` on
    /// the Subscribe stream. Defaults to a random uuid generated at boot
    /// when not provided.
    #[envconfig(from = "SERVICE_INSTANCE_ID")]
    pub service_instance_id: Option<String>,

    /// Default cadence for the freshness/draining `Subscribe` RPC in
    /// milliseconds. Callers may suggest a cadence via
    /// `SubscribeRequest.tick_hint_ms`; the server clamps to
    /// `[subscribe_min_tick_ms, subscribe_max_tick_ms]` so a misbehaving
    /// caller cannot induce excess work.
    #[envconfig(from = "SUBSCRIBE_TICK_INTERVAL_MS", default = "1000")]
    pub subscribe_tick_interval_ms: u64,

    /// Lower bound for the load-event tick cadence. Hints below this are
    /// clamped up.
    #[envconfig(from = "SUBSCRIBE_MIN_TICK_MS", default = "100")]
    pub subscribe_min_tick_ms: u64,

    /// Upper bound for the load-event tick cadence. Hints above this are
    /// clamped down so a misconfigured caller cannot make the stream stale.
    #[envconfig(from = "SUBSCRIBE_MAX_TICK_MS", default = "10000")]
    pub subscribe_max_tick_ms: u64,
}