Struct BasicConf

pub struct BasicConf {

    pub name: Option<String>,
    pub error_template: Option<String>,
    pub pid_file: Option<String>,
    pub upgrade_sock: Option<String>,
    pub user: Option<String>,
    pub group: Option<String>,
    pub threads: Option<usize>,
    pub work_stealing: Option<bool>,
    pub listener_tasks_per_fd: Option<usize>,
    pub grace_period: Option<Duration>,
    pub graceful_shutdown_timeout: Option<Duration>,
    pub upstream_keepalive_pool_size: Option<usize>,
    pub webhook: Option<String>,
    pub webhook_type: Option<String>,
    pub webhook_notifications: Option<Vec<String>>,
    pub log_level: Option<String>,
    pub log_buffered_size: Option<ByteSize>,
    pub log_format_json: Option<bool>,
    pub sentry: Option<String>,
    pub pyroscope: Option<String>,
    pub auto_restart_check_interval: Option<Duration>,
    pub cache_directory: Option<String>,
    pub cache_max_size: Option<ByteSize>,
}

Basic configuration options for the application

Fields

name: Option<String>

Application name

error_template: Option<String>

Error page template

pid_file: Option<String>

Path to PID file (default: /run/pingap.pid)

upgrade_sock: Option<String>

Unix domain socket path for graceful upgrades(default: /tmp/pingap_upgrade.sock)

user: Option<String>

User for daemon

group: Option<String>

Group for daemon

threads: Option<usize>

Number of worker threads(default: 1)

work_stealing: Option<bool>

Enable work stealing between worker threads(default: true)

listener_tasks_per_fd: Option<usize>

Number of listener tasks to use per fd. This allows for parallel accepts.

grace_period: Option<Duration>

Grace period before forcefully terminating during shutdown(default: 5m)

graceful_shutdown_timeout: Option<Duration>

Maximum time to wait for graceful shutdown

upstream_keepalive_pool_size: Option<usize>

Maximum number of idle connections to keep in upstream connection pool

webhook: Option<String>

Webhook URL for notifications

webhook_type: Option<String>

Type of webhook (e.g. “wecom”, “dingtalk”)

webhook_notifications: Option<Vec<String>>

List of events to send webhook notifications for

log_level: Option<String>

Log level (debug, info, warn, error)

log_buffered_size: Option<ByteSize>

Size of log buffer before flushing

log_format_json: Option<bool>

Whether to format logs as JSON

sentry: Option<String>

Sentry DSN for error reporting

pyroscope: Option<String>

Pyroscope server URL for continuous profiling

auto_restart_check_interval: Option<Duration>

How often to check for configuration changes that require restart

cache_directory: Option<String>

Directory to store cache files

cache_max_size: Option<ByteSize>

Maximum size of cache storage

Implementations

impl BasicConf

pub fn get_pid_file(&self) -> String

Returns the path to the PID file

• If pid_file is explicitly configured, uses that value
• Otherwise tries to use /run/pingap.pid or /var/run/pingap.pid if writable
• Falls back to /tmp/pingap.pid if neither system directories are writable

Trait Implementations

impl Clone for BasicConf

fn clone(&self) -> BasicConf

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for BasicConf

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for BasicConf

fn default() -> BasicConf

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for BasicConf

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for BasicConf

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.