配置说明

Pingap使用toml来配置相关参数，对于时间类的配置，格式为1s, 1m, 1h这种时间表示形式。而对于存储大小类的配置，格式为1kb, 1mb, 1gb这种表示方式。具体参数说明如下：

基础配置

• name: 实例名称，默认为Pingap
• error_template: 参数可选，异常出错时的html模板，可自定义出错的html模板，在出错时会替换模板中的{{version}}为pingap的版本号，{{content}}为出错的具体信息
• pid_file: 参数可选，默认为/tmp/pingap.pid，此参数配置进程id的记录文件
• upgrade_sock: 参数可选，默认为/tmp/pingap_upgrade.sock，此参数配置程序无中断式更新时的socket路径，用于新的pingap进程与旧进程之间切换时使用
• user: 参数可选，默认为空，用于设置守护进程的执行用户
• group: 参数可选，默认为空，与user类似
• threads: 参数可选，默认为1，用于设置每个服务(如server监听的tcp连接)使用的线程数，如果设置为0，则使用cpu或cgroup限制核数
• work_stealing: 参数可选，默认为true，是否允许同服务中的不同线程的抢占工作
• grace_period: 设置优雅退出的等待周期，默认为5分钟
• graceful_shutdown_timeout: 设置优雅退出关闭超时时长，默认为5秒
• upstream_keepalive_pool_size: 设置upstream保持连接的连接池大小，默认为128
• webhook: Webhook的请求路径
• webhook_type: Webhook的类型，支持普通的http形式、webcom与dingtalk三种类型
• webhook_notifications: Webhook通知的类型，有backend_status，lets_encrypt，diff_config，restart，restart_fail以及tls_validity
• log_level: 应用日志的输出级别
• log_buffered_size: 日志缓存区大小
• log_format_json: 设置为json格式化日志
• sentry: Sentry的DSN配置
• pyroscope: Pyroscope连接地址，需要注意默认版本并未编译支持pyroscpe，需要使用perf的版本
• auto_restart_check_interval: 检测配置更新的间隔，默认为每90秒检测一次，若配置为小于1秒的值，则不检测
• cache_directory: 设置缓存目录，设置之后则使用文件形式缓存
• cache_max_size: 缓存空间的最大限制，缓存是程序中所有服务共用

upstreams

Upstream的相关配置说明可查看Upstream的详细说明

Location

Location的相关配置说明可查看Location的详细说明

Server

• server.x: server的配置，其中x为server的名称，需要注意名称不要相同，相同名称的配置会被覆盖。
• addr: 监控的端口地址，地址格式为ip:port的形式，若需要监听多地址则以,分隔
• access_log: 可选，默认为不输出访问日志。请求日志格式化，指定输出访问日志的形式。提供了以下几种常用的日志输出格式combined, common, short, tiny
• locations: location的列表，指定该server使用的location
• threads: 设置服务默认的线程数，设置为0则等于cpu核数，默认为1
• tls_cipher_list: 指定tls1.3之前版本使用的加密套件
• tls_ciphersuites: 指定tls1.3版本使用的加密套件
• tls_min_version: 指定tls的最低版本，默认为1.2
• tls_max_version: 指定tls的最低版本，默认为1.3
• global_certificates: 启用全局证书配置
• enabled_h2: 是否启用http2，默认为不启用，需要注意，如果是http则使用h2c的形式
• tcp_idle: tcp连接keepalive空闲回收时长
• tcp_interval: tcp连接keepavlie检测时长
• tcp_probe_count: tcp连接keepalvie探针检测次数
• tcp_fastopen: 启用tcp快速启动，并设置backlog的大小
• prometheus_metrics: 设置启用prometheus，如果配置为http形式的则为push的形式，如果只配置路径则提供pull的请求路径
• otlp_exporter: 设置opentemletry数据收集器的地址