Apache SkyWalking OAP 后端部署与配置完全指南发行包结构、启动方式与 application.yml 模块化配置详解【免费下载链接】skywalkingAPM, Application Performance Monitoring System项目地址: https://gitcode.com/gh_mirrors/sky/skywalking本指南以 Apache SkyWalking 官方文档 backend-setup.md 为核心骨架结合当前仓库中 OAP 服务端真实源码oap-server/server-starter与发行物料dist-material系统讲解 SkyWalking 后端OAP的发行包组成、默认端口与前置要求、三种启动模式、启动日志关键参数以及application.yml三层模块化配置体系。读完本文你将能够独立完成 OAP 后端的快速启动、理解其默认行为边界并具备在生产/测试环境基于模块化配置定制后端的能力。一、发行包结构理解 OAP 分发物的四个组成部分SkyWalking 的后端发行包distribution package由以下四部分组成这份结构决定了你拿到官方 release 包后各文件、目录的用途组成部分位置内容与作用bin/cmd 启动脚本/bin目录包含后端OAP与 UI 的启动脚本提供 Linux Shell.sh与 Windows Cmd.bat两种形式后端配置/config目录后端核心配置文件包括application.yml模块化主配置、log4j.xml日志框架配置、alarm-settings.yml告警规则后端依赖库/oap-libs目录OAP 后端运行所需的全部第三方依赖 jar 包Webapp 环境webapp目录UI 前端 jar 文件及其配套的webapp.yml设置文件以当前仓库为例dist-material目录即为发行物模板dist-material/bin/oapService.sh是 Linux 启动脚本dist-material/config-examples/alarm-settings.yml对应发行包/config/alarm-settings.yml的示例dist-material/log4j2.xml对应日志配置。发行时这些文件会被组装到对应的bin、config、oap-libs、webapp目录下。关于 UI 的配置发行包中 UI 的设置文件位于webapp/webapp.yml相关内容可参阅 UI 部署文档。二、环境要求与默认设置2.1 运行时要求运行 SkyWalking 后端的最低要求是Java 11/17/21当前仓库 README 与文档均以这三个 LTS 版本为基准。注意下述 quickstart 快速启动的核心目的是帮你以最简配置获得一份可用于预览/演示previews/demos的环境。它的性能与长期运行能力不在设计目标之内。生产、QA、测试环境请参考 Backend and UI deployment documents。2.2 默认端口与默认存储执行bin/startup.sh或.bat即可按默认设置同时启动后端与 UI默认行为如下后端存储默认使用 H2内存数据库方便开箱即用后端监听0.0.0.0:11800提供 gRPC API遥测数据上报通道后端监听0.0.0.0:12800提供 HTTP REST API查询与部分上报通道UI 监听8080端口并向127.0.0.1:12800发起 GraphQL 查询。对于 Java、.NET Core、Node.js 以及 Istio 等语言级 Agent/探针需要把 gRPC 服务地址配置为ip/host:11800其中 IP/host 即你的后端所在主机地址。这些默认值在 server-starter 的 application.yml 中有明确对应core.default.gRPCHost/gRPCPort默认0.0.0.0/11800core.default.restHost/restPort默认0.0.0.0/12800storage.selector默认${SW_STORAGE:h2}。UI 侧webapp.yml中serverPort默认-8080、oapServices默认http://localhost:12800见 ui-setup.md。2.3 组件交互链路在把 SkyWalking 部署到分布式环境之前需要理解 Agent/探针、后端、UI 三者之间的通信方式绝大多数原生 Agent 与探针包括基于语言的和 Service Mesh 探针使用application.yml中core/default/gRPC*所配置的gRPC 服务向后端上报数据同时后端也支持JSON 格式的 REST 上报。**UI 使用 GraphQLHTTP 协议**通过core/default/rest*配置的 REST 服务访问后端完成查询。即Agent/Probe --gRPC(11800)-- OAP --GraphQL/HTTP(12800)-- UI监控数据从探针流入查询请求从 UI 流出。三、启动脚本与三种启动模式3.1 默认启动脚本默认启动脚本为/bin/oapService.shWindows 为.bat。查看仓库中的 dist-material/bin/oapService.sh 源码可以了解其核心逻辑PRG$0 PRGDIR$(dirname $PRG) [ -z $OAP_HOME ] OAP_HOME$(cd $PRGDIR/.. /dev/null || exit 1; pwd) OAP_LOG_DIR${OAP_LOG_DIR:-${OAP_HOME}/logs} JAVA_OPTS${JAVA_OPTS:- -Xms256M -Xmx4096M} ... _RUNJAVA${JAVA_HOME}/bin/java [ -z $JAVA_HOME ] _RUNJAVAjava CLASSPATH$OAP_HOME/config for i in $OAP_HOME/oap-libs/*.jar do CLASSPATH$i:$CLASSPATH done OAP_OPTIONS -Doap.logDir${OAP_LOG_DIR} eval exec \$_RUNJAVA\ ${JAVA_OPTS} ${OAP_OPTIONS} -classpath $CLASSPATH org.apache.skywalking.oap.server.starter.OAPServerStartUp \ 2${OAP_LOG_DIR}/oap.log从脚本可见三个关键事实堆内存默认值-Xms256M -Xmx4096M即初始堆 256MB、最大堆 4GB可通过JAVA_OPTS环境变量覆盖日志输出位置logs/oap.log由OAP_LOG_DIR决定且通过-Doap.logDir传入 JVM启动入口类org.apache.skywalking.oap.server.starter.OAPServerStartUp其上层由 OAPServerBootstrap 负责加载application.yml通过ApplicationConfigLoader并交给ModuleManager初始化整个模块体系。除了默认模式SkyWalking 还提供了两种可选启动模式详见 启动模式文档模式脚本行为Default默认/bin/oapService.sh(.bat)按需执行初始化、开始监听并提供服务使用startup.sh(.bat) 时同样生效Init初始化/bin/oapServiceInit.sh(.bat)OAP 启动完成初始化后立即退出用于初始化存储如 ElasticSearch 索引、MySQL/TiDB 表结构与数据No-init跳过初始化/bin/oapServiceNoInit.sh(.bat)OAP 启动时不执行初始化而是等待检测到 ElasticSearch 索引、MySQL、TiDB 等存储表已就绪后再监听并提供服务适用于已有其他 OAP 实例完成初始化的场景在 OAPServerBootstrap 中可以看到模式机制的实际落地通过 JVM 系统属性mode设置RunningMode当RunningMode.isInitMode()为真时初始化完成后即打印日志并System.exit(0)退出。四、启动日志中的关键参数Booting LogsOAP 启动完成后日志中会列出全部关键启动参数。以下是文档中给出的 9.7.0-SNAPSHOT 版本的完整输出示例2023-11-06 21:10:45,988 org.apache.skywalking.oap.server.starter.OAPServerBootstrap 67 [main] INFO [] - The key booting parameters of Apache SkyWalking OAP are listed as following. Running Mode | null TTL.metrics | 7 TTL.record | 3 Version | 9.7.0-SNAPSHOT-92af797 module.agent-analyzer.provider | default module.ai-pipeline.provider | default module.alarm.provider | default module.aws-firehose.provider | default module.cluster.provider | standalone module.configuration-discovery.provider | default module.configuration.provider | none module.core.provider | default module.envoy-metric.provider | default module.event-analyzer.provider | default module.log-analyzer.provider | default module.logql.provider | default module.promql.provider | default module.query.provider | graphql module.receiver-browser.provider | default module.receiver-clr.provider | default module.receiver-ebpf.provider | default module.receiver-event.provider | default module.receiver-jvm.provider | default module.receiver-log.provider | default module.receiver-meter.provider | default module.receiver-otel.provider | default module.receiver-profile.provider | default module.receiver-register.provider | default module.receiver-sharing-server.provider | default module.receiver-telegraf.provider | default module.receiver-trace.provider | default module.service-mesh.provider | default module.storage.provider | h2 module.telemetry.provider | none oap.external.grpc.host | 0.0.0.0 oap.external.grpc.port | 11800 oap.external.http.host | 0.0.0.0 oap.external.http.port | 12800 oap.internal.comm.host | 0.0.0.0 oap.internal.comm.port | 11800这三组网络参数的含义需要特别区分oap.external.grpc.host:oap.external.grpc.portgRPC 通道上报遥测数据的入口服务对象包括原生 Agent 与 OTEL等外部采集端oap.external.http.host:oap.external.http.portHTTP 通道上报遥测数据与查询的入口服务对象包括原生 GraphQLUI、PromQL、LogQLoap.internal.comm.host:oap.internal.comm.portOAP集群内部通过 gRPC/HTTP2 协议通信的地址。默认主机0.0.0.0在集群模式下并不合适除非在 k8s 部署中集群模式下的正确配置方式请阅读 Cluster Doc。日志输出机制本身由 OAPServerBootstrap 实现它创建TerminalFriendlyTable收集Running Mode、Version以及ApplicationConfigLoader解析出的全部配置在启动完成无论成败后统一打印。五、application.yml三层模块化配置体系SkyWalking 后端的一切启动行为都由config/application.yml驱动。理解这份文件是阅读后续所有部署文档的前提。其背后的核心设计理念是SkyWalking Collector 基于纯模块化pure modular设计终端用户可以根据自身需求切换或组装 Collector 的功能。5.1 三个配置层级在application.yml中存在三个层级Level 1 —— 模块名Module name声明该模块在运行模式中处于激活状态Level 2 —— Provider 选项列表与 Provider 选择器selector列出可用的 provider并用 selector 指明实际生效的那个。如果只列出一个 provider则selector可省略Level 3 —— 被选中 Provider 的设置项。5.2 配置示例storage 模块文档给出的完整示例以存储模块为例演示 H2 与 MySQL 两个 provider 的并存与切换storage: selector: mysql # the mysql storage will actually be activated, while the h2 storage takes no effect h2: properties: jdbcUrl: ${SW_STORAGE_H2_URL:jdbc:h2:mem:skywalking-oap-db;DB_CLOSE_DELAY-1;DATABASE_TO_UPPERFALSE} dataSource.user: ${SW_STORAGE_H2_USER:sa} metadataQueryMaxSize: ${SW_STORAGE_H2_QUERY_MAX_SIZE:5000} mysql: properties: jdbcUrl: ${SW_JDBC_URL:jdbc:mysql://localhost:3306/swtest?allowMultiQueriestrue} dataSource.user: ${SW_DATA_SOURCE_USER:root} dataSource.password: ${SW_DATA_SOURCE_PASSWORD:root1234} dataSource.cachePrepStmts: ${SW_DATA_SOURCE_CACHE_PREP_STMTS:true} dataSource.prepStmtCacheSize: ${SW_DATA_SOURCE_PREP_STMT_CACHE_SQL_SIZE:250} dataSource.prepStmtCacheSqlLimit: ${SW_DATA_SOURCE_PREP_STMT_CACHE_SQL_LIMIT:2048} dataSource.useServerPrepStmts: ${SW_DATA_SOURCE_USE_SERVER_PREP_STMTS:true} metadataQueryMaxSize: ${SW_STORAGE_MYSQL_QUERY_MAX_SIZE:5000} # other configurations逐项解读storage是模块名selector从下方列出的所有 provider 中选出唯一生效者未选中的 provider 视为被删除、完全不生效示例中selector: mysql表示激活 MySQL 存储H2 存储被忽略jdbcUrl、dataSource.user、metadataQueryMaxSize等均为该 provider实现者的设置项。对比当前仓库中 server-starter 的 application.yml 可以看出实际配置文件的storage.selector默认值是${SW_STORAGE:h2}即默认 H2可通过环境变量SW_STORAGE覆盖且除 h2、mysql 外还预置了 elasticsearch、postgresql、banyandb 等多个 providerMySQL 的jdbcUrl默认值还追加了rewriteBatchedStatementstrue以支持批量写入。所有配置项均采用${SW_XXX:默认值}的占位符写法这意味着每一项都可以通过同名环境变量或 JVM 系统属性在启动时无侵入覆盖这也是 backend-setting-override.md 所讲配置覆盖机制的来源。5.3 必需模块与可选模块模块分为两类必需模块required与可选模块optional。必需模块提供了后端的基本骨架。虽然模块化设计支持插拔但移除这些模块没有任何意义官方文档也明确建议除非你对 SkyWalking 项目及其代码非常熟悉否则不要改动这些模块的 API。必需模块包括Core提供所有数据分析与流式分发stream dispatch的基础和主要骨架Cluster管理集群中的多个后端实例以提供高吞吐处理能力详见Cluster ManagementStorage使分析结果持久化详见Choose storageQuery为 UI 提供查询接口Receiver 与 Fetcher向 Agent 与探针暴露服务或从某个通道读取遥测数据。可选模块中部分模块提供名为none的 provider 实现——它只是一个没有实际逻辑的空壳典型如telemetry监控自身指标。将selector设置为-意味着整个模块将在运行时被排除。例如仓库配置中telemetry.selector: ${SW_TELEMETRY:none}默认空壳可通过SW_TELEMETRYprometheus启用自监控kafka-fetcher.selector: ${SW_KAFKA_FETCHER:-}、exporter.selector: ${SW_EXPORTER:-}、receiver-zipkin.selector: ${SW_RECEIVER_ZIPKIN:-}、cilium-fetcher.selector: ${SW_CILIUM_FETCHER:-}等默认即为-表示默认运行时不加载这些模块需要时通过对应环境变量打开。从启动日志第四节可以直观看到模块选择的最终结果module.storage.provider | h2、module.cluster.provider | standalone、module.query.provider | graphql、module.telemetry.provider | none这些值正是 selector 解析后的结果。六、FAQ为什么需要设置时区何时设置SkyWalking 提供了降采样downsampling时间序列指标能力它会在分钟、小时、日、月等各个时间维度上建立指标索引并在时间格式化时依赖时区。例如分钟维度的指标时间会被格式化为yyyyMMddHHmm这个字符串是与时区强相关的。默认情况下SkyWalking OAP 后端采用OS 默认时区如需覆盖时区请遵循 Java 与操作系统自身的文档来调整例如通过-Duser.timezone指定 JVM 时区。七、下一步从快速启动走向生产部署本文覆盖的是从零启动到理解配置骨架的完整路径。在此基础上根据你的实际环境可进一步参考多实例集群backend-cluster.mdZooKeeper/Consul/etcd/Nacos/Kubernetes 等集群协调方式存储选型backend-storage.mdElasticSearch、MySQL、PostgreSQL、BanyanDB 等生产部署与 UI 配置ui-setup.md、advanced-deployment.md配置热更新backend-setting-override.md 与 dynamic-config.mdDocker 部署backend-docker.md仓库中也提供了 docker/oap 的 Dockerfile 与 docker-entrypoint.sh 可直接参考。记住快速启动默认的 H2 存储与单机 standalone 模式只适合预览与演示进入生产环境前务必按照上述部署文档完成存储、集群、UI 与安全如 backend-token-auth.md 的 Token 鉴权的完整规划。【免费下载链接】skywalkingAPM, Application Performance Monitoring System项目地址: https://gitcode.com/gh_mirrors/sky/skywalking创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Apache SkyWalking OAP 后端部署与配置完全指南发行包结构、启动方式与 application.yml 模块化配置详解【免费下载链接】skywalkingAPM, Application Performance Monitoring System项目地址: https://gitcode.com/gh_mirrors/sky/skywalking本指南以 Apache SkyWalking 官方文档 backend-setup.md 为核心骨架结合当前仓库中 OAP 服务端真实源码oap-server/server-starter与发行物料dist-material系统讲解 SkyWalking 后端OAP的发行包组成、默认端口与前置要求、三种启动模式、启动日志关键参数以及application.yml三层模块化配置体系。读完本文你将能够独立完成 OAP 后端的快速启动、理解其默认行为边界并具备在生产/测试环境基于模块化配置定制后端的能力。一、发行包结构理解 OAP 分发物的四个组成部分SkyWalking 的后端发行包distribution package由以下四部分组成这份结构决定了你拿到官方 release 包后各文件、目录的用途组成部分位置内容与作用bin/cmd 启动脚本/bin目录包含后端OAP与 UI 的启动脚本提供 Linux Shell.sh与 Windows Cmd.bat两种形式后端配置/config目录后端核心配置文件包括application.yml模块化主配置、log4j.xml日志框架配置、alarm-settings.yml告警规则后端依赖库/oap-libs目录OAP 后端运行所需的全部第三方依赖 jar 包Webapp 环境webapp目录UI 前端 jar 文件及其配套的webapp.yml设置文件以当前仓库为例dist-material目录即为发行物模板dist-material/bin/oapService.sh是 Linux 启动脚本dist-material/config-examples/alarm-settings.yml对应发行包/config/alarm-settings.yml的示例dist-material/log4j2.xml对应日志配置。发行时这些文件会被组装到对应的bin、config、oap-libs、webapp目录下。关于 UI 的配置发行包中 UI 的设置文件位于webapp/webapp.yml相关内容可参阅 UI 部署文档。二、环境要求与默认设置2.1 运行时要求运行 SkyWalking 后端的最低要求是Java 11/17/21当前仓库 README 与文档均以这三个 LTS 版本为基准。注意下述 quickstart 快速启动的核心目的是帮你以最简配置获得一份可用于预览/演示previews/demos的环境。它的性能与长期运行能力不在设计目标之内。生产、QA、测试环境请参考 Backend and UI deployment documents。2.2 默认端口与默认存储执行bin/startup.sh或.bat即可按默认设置同时启动后端与 UI默认行为如下后端存储默认使用 H2内存数据库方便开箱即用后端监听0.0.0.0:11800提供 gRPC API遥测数据上报通道后端监听0.0.0.0:12800提供 HTTP REST API查询与部分上报通道UI 监听8080端口并向127.0.0.1:12800发起 GraphQL 查询。对于 Java、.NET Core、Node.js 以及 Istio 等语言级 Agent/探针需要把 gRPC 服务地址配置为ip/host:11800其中 IP/host 即你的后端所在主机地址。这些默认值在 server-starter 的 application.yml 中有明确对应core.default.gRPCHost/gRPCPort默认0.0.0.0/11800core.default.restHost/restPort默认0.0.0.0/12800storage.selector默认${SW_STORAGE:h2}。UI 侧webapp.yml中serverPort默认-8080、oapServices默认http://localhost:12800见 ui-setup.md。2.3 组件交互链路在把 SkyWalking 部署到分布式环境之前需要理解 Agent/探针、后端、UI 三者之间的通信方式绝大多数原生 Agent 与探针包括基于语言的和 Service Mesh 探针使用application.yml中core/default/gRPC*所配置的gRPC 服务向后端上报数据同时后端也支持JSON 格式的 REST 上报。**UI 使用 GraphQLHTTP 协议**通过core/default/rest*配置的 REST 服务访问后端完成查询。即Agent/Probe --gRPC(11800)-- OAP --GraphQL/HTTP(12800)-- UI监控数据从探针流入查询请求从 UI 流出。三、启动脚本与三种启动模式3.1 默认启动脚本默认启动脚本为/bin/oapService.shWindows 为.bat。查看仓库中的 dist-material/bin/oapService.sh 源码可以了解其核心逻辑PRG$0 PRGDIR$(dirname $PRG) [ -z $OAP_HOME ] OAP_HOME$(cd $PRGDIR/.. /dev/null || exit 1; pwd) OAP_LOG_DIR${OAP_LOG_DIR:-${OAP_HOME}/logs} JAVA_OPTS${JAVA_OPTS:- -Xms256M -Xmx4096M} ... _RUNJAVA${JAVA_HOME}/bin/java [ -z $JAVA_HOME ] _RUNJAVAjava CLASSPATH$OAP_HOME/config for i in $OAP_HOME/oap-libs/*.jar do CLASSPATH$i:$CLASSPATH done OAP_OPTIONS -Doap.logDir${OAP_LOG_DIR} eval exec \$_RUNJAVA\ ${JAVA_OPTS} ${OAP_OPTIONS} -classpath $CLASSPATH org.apache.skywalking.oap.server.starter.OAPServerStartUp \ 2${OAP_LOG_DIR}/oap.log从脚本可见三个关键事实堆内存默认值-Xms256M -Xmx4096M即初始堆 256MB、最大堆 4GB可通过JAVA_OPTS环境变量覆盖日志输出位置logs/oap.log由OAP_LOG_DIR决定且通过-Doap.logDir传入 JVM启动入口类org.apache.skywalking.oap.server.starter.OAPServerStartUp其上层由 OAPServerBootstrap 负责加载application.yml通过ApplicationConfigLoader并交给ModuleManager初始化整个模块体系。除了默认模式SkyWalking 还提供了两种可选启动模式详见 启动模式文档模式脚本行为Default默认/bin/oapService.sh(.bat)按需执行初始化、开始监听并提供服务使用startup.sh(.bat) 时同样生效Init初始化/bin/oapServiceInit.sh(.bat)OAP 启动完成初始化后立即退出用于初始化存储如 ElasticSearch 索引、MySQL/TiDB 表结构与数据No-init跳过初始化/bin/oapServiceNoInit.sh(.bat)OAP 启动时不执行初始化而是等待检测到 ElasticSearch 索引、MySQL、TiDB 等存储表已就绪后再监听并提供服务适用于已有其他 OAP 实例完成初始化的场景在 OAPServerBootstrap 中可以看到模式机制的实际落地通过 JVM 系统属性mode设置RunningMode当RunningMode.isInitMode()为真时初始化完成后即打印日志并System.exit(0)退出。四、启动日志中的关键参数Booting LogsOAP 启动完成后日志中会列出全部关键启动参数。以下是文档中给出的 9.7.0-SNAPSHOT 版本的完整输出示例2023-11-06 21:10:45,988 org.apache.skywalking.oap.server.starter.OAPServerBootstrap 67 [main] INFO [] - The key booting parameters of Apache SkyWalking OAP are listed as following. Running Mode | null TTL.metrics | 7 TTL.record | 3 Version | 9.7.0-SNAPSHOT-92af797 module.agent-analyzer.provider | default module.ai-pipeline.provider | default module.alarm.provider | default module.aws-firehose.provider | default module.cluster.provider | standalone module.configuration-discovery.provider | default module.configuration.provider | none module.core.provider | default module.envoy-metric.provider | default module.event-analyzer.provider | default module.log-analyzer.provider | default module.logql.provider | default module.promql.provider | default module.query.provider | graphql module.receiver-browser.provider | default module.receiver-clr.provider | default module.receiver-ebpf.provider | default module.receiver-event.provider | default module.receiver-jvm.provider | default module.receiver-log.provider | default module.receiver-meter.provider | default module.receiver-otel.provider | default module.receiver-profile.provider | default module.receiver-register.provider | default module.receiver-sharing-server.provider | default module.receiver-telegraf.provider | default module.receiver-trace.provider | default module.service-mesh.provider | default module.storage.provider | h2 module.telemetry.provider | none oap.external.grpc.host | 0.0.0.0 oap.external.grpc.port | 11800 oap.external.http.host | 0.0.0.0 oap.external.http.port | 12800 oap.internal.comm.host | 0.0.0.0 oap.internal.comm.port | 11800这三组网络参数的含义需要特别区分oap.external.grpc.host:oap.external.grpc.portgRPC 通道上报遥测数据的入口服务对象包括原生 Agent 与 OTEL等外部采集端oap.external.http.host:oap.external.http.portHTTP 通道上报遥测数据与查询的入口服务对象包括原生 GraphQLUI、PromQL、LogQLoap.internal.comm.host:oap.internal.comm.portOAP集群内部通过 gRPC/HTTP2 协议通信的地址。默认主机0.0.0.0在集群模式下并不合适除非在 k8s 部署中集群模式下的正确配置方式请阅读 Cluster Doc。日志输出机制本身由 OAPServerBootstrap 实现它创建TerminalFriendlyTable收集Running Mode、Version以及ApplicationConfigLoader解析出的全部配置在启动完成无论成败后统一打印。五、application.yml三层模块化配置体系SkyWalking 后端的一切启动行为都由config/application.yml驱动。理解这份文件是阅读后续所有部署文档的前提。其背后的核心设计理念是SkyWalking Collector 基于纯模块化pure modular设计终端用户可以根据自身需求切换或组装 Collector 的功能。5.1 三个配置层级在application.yml中存在三个层级Level 1 —— 模块名Module name声明该模块在运行模式中处于激活状态Level 2 —— Provider 选项列表与 Provider 选择器selector列出可用的 provider并用 selector 指明实际生效的那个。如果只列出一个 provider则selector可省略Level 3 —— 被选中 Provider 的设置项。5.2 配置示例storage 模块文档给出的完整示例以存储模块为例演示 H2 与 MySQL 两个 provider 的并存与切换storage: selector: mysql # the mysql storage will actually be activated, while the h2 storage takes no effect h2: properties: jdbcUrl: ${SW_STORAGE_H2_URL:jdbc:h2:mem:skywalking-oap-db;DB_CLOSE_DELAY-1;DATABASE_TO_UPPERFALSE} dataSource.user: ${SW_STORAGE_H2_USER:sa} metadataQueryMaxSize: ${SW_STORAGE_H2_QUERY_MAX_SIZE:5000} mysql: properties: jdbcUrl: ${SW_JDBC_URL:jdbc:mysql://localhost:3306/swtest?allowMultiQueriestrue} dataSource.user: ${SW_DATA_SOURCE_USER:root} dataSource.password: ${SW_DATA_SOURCE_PASSWORD:root1234} dataSource.cachePrepStmts: ${SW_DATA_SOURCE_CACHE_PREP_STMTS:true} dataSource.prepStmtCacheSize: ${SW_DATA_SOURCE_PREP_STMT_CACHE_SQL_SIZE:250} dataSource.prepStmtCacheSqlLimit: ${SW_DATA_SOURCE_PREP_STMT_CACHE_SQL_LIMIT:2048} dataSource.useServerPrepStmts: ${SW_DATA_SOURCE_USE_SERVER_PREP_STMTS:true} metadataQueryMaxSize: ${SW_STORAGE_MYSQL_QUERY_MAX_SIZE:5000} # other configurations逐项解读storage是模块名selector从下方列出的所有 provider 中选出唯一生效者未选中的 provider 视为被删除、完全不生效示例中selector: mysql表示激活 MySQL 存储H2 存储被忽略jdbcUrl、dataSource.user、metadataQueryMaxSize等均为该 provider实现者的设置项。对比当前仓库中 server-starter 的 application.yml 可以看出实际配置文件的storage.selector默认值是${SW_STORAGE:h2}即默认 H2可通过环境变量SW_STORAGE覆盖且除 h2、mysql 外还预置了 elasticsearch、postgresql、banyandb 等多个 providerMySQL 的jdbcUrl默认值还追加了rewriteBatchedStatementstrue以支持批量写入。所有配置项均采用${SW_XXX:默认值}的占位符写法这意味着每一项都可以通过同名环境变量或 JVM 系统属性在启动时无侵入覆盖这也是 backend-setting-override.md 所讲配置覆盖机制的来源。5.3 必需模块与可选模块模块分为两类必需模块required与可选模块optional。必需模块提供了后端的基本骨架。虽然模块化设计支持插拔但移除这些模块没有任何意义官方文档也明确建议除非你对 SkyWalking 项目及其代码非常熟悉否则不要改动这些模块的 API。必需模块包括Core提供所有数据分析与流式分发stream dispatch的基础和主要骨架Cluster管理集群中的多个后端实例以提供高吞吐处理能力详见Cluster ManagementStorage使分析结果持久化详见Choose storageQuery为 UI 提供查询接口Receiver 与 Fetcher向 Agent 与探针暴露服务或从某个通道读取遥测数据。可选模块中部分模块提供名为none的 provider 实现——它只是一个没有实际逻辑的空壳典型如telemetry监控自身指标。将selector设置为-意味着整个模块将在运行时被排除。例如仓库配置中telemetry.selector: ${SW_TELEMETRY:none}默认空壳可通过SW_TELEMETRYprometheus启用自监控kafka-fetcher.selector: ${SW_KAFKA_FETCHER:-}、exporter.selector: ${SW_EXPORTER:-}、receiver-zipkin.selector: ${SW_RECEIVER_ZIPKIN:-}、cilium-fetcher.selector: ${SW_CILIUM_FETCHER:-}等默认即为-表示默认运行时不加载这些模块需要时通过对应环境变量打开。从启动日志第四节可以直观看到模块选择的最终结果module.storage.provider | h2、module.cluster.provider | standalone、module.query.provider | graphql、module.telemetry.provider | none这些值正是 selector 解析后的结果。六、FAQ为什么需要设置时区何时设置SkyWalking 提供了降采样downsampling时间序列指标能力它会在分钟、小时、日、月等各个时间维度上建立指标索引并在时间格式化时依赖时区。例如分钟维度的指标时间会被格式化为yyyyMMddHHmm这个字符串是与时区强相关的。默认情况下SkyWalking OAP 后端采用OS 默认时区如需覆盖时区请遵循 Java 与操作系统自身的文档来调整例如通过-Duser.timezone指定 JVM 时区。七、下一步从快速启动走向生产部署本文覆盖的是从零启动到理解配置骨架的完整路径。在此基础上根据你的实际环境可进一步参考多实例集群backend-cluster.mdZooKeeper/Consul/etcd/Nacos/Kubernetes 等集群协调方式存储选型backend-storage.mdElasticSearch、MySQL、PostgreSQL、BanyanDB 等生产部署与 UI 配置ui-setup.md、advanced-deployment.md配置热更新backend-setting-override.md 与 dynamic-config.mdDocker 部署backend-docker.md仓库中也提供了 docker/oap 的 Dockerfile 与 docker-entrypoint.sh 可直接参考。记住快速启动默认的 H2 存储与单机 standalone 模式只适合预览与演示进入生产环境前务必按照上述部署文档完成存储、集群、UI 与安全如 backend-token-auth.md 的 Token 鉴权的完整规划。【免费下载链接】skywalkingAPM, Application Performance Monitoring System项目地址: https://gitcode.com/gh_mirrors/sky/skywalking创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
