Project: SkyWalking (Observability and Analysis / Observability)
File: configuration-vocabulary.md

The Configuration Vocabulary lists all available configurations provided by `application.yml`. | Module | Provider | Settings | Value(s) and Explanation | System Environment Variable | Default | |-||--|-|-|-| | core | default | role | Option values: `Mixed/Receiver/Aggregator`. Receiver mode OAP opens the service to the agents, then analyzes and aggregates the results, and forwards the results for distributed aggregation. Aggregator mode OAP receives data from Mixer and Receiver role OAP nodes, and performs 2nd level aggregation. Mixer means both Receiver and Aggregator. | SWCOREROLE | Mixed | | - | - | restHost | Binding IP of RESTful services. Services include GraphQL query and HTTP data report. | SWCOREREST_HOST | 0.0.0.0 | | - | - | restPort | Binding port of RESTful services. | SWCOREREST_PORT | 12800 | | - | - | restContextPath | Web context path of RESTful services. | SWCORERESTCONTEXTPATH | / | | - | - | restMaxThreads | Maximum thread number of RESTful services. | SWCORERESTRESTMAX_THREADS | 200 | | - | - | restIdleTimeOut | Connector idle timeout of RESTful services (in milliseconds). | SWCORERESTIDLETIMEOUT | 30000 | | - | - | restAcceptQueueSize | ServerSocketChannel Backlog of RESTful services. | SWCORERESTQUEUESIZE | 0 | | - | - | httpMaxRequestHeaderSize | Maximum request header size accepted. | SWCOREHTTPMAXREQUESTHEADERSIZE | 8192 | | - | - | gRPCHost | Binding IP of gRPC services, including gRPC data report and internal communication among OAP nodes. | SWCOREGRPC_HOST | 0.0.0.0 | | - | - | gRPCPort | Binding port of gRPC services. | SWCOREGRPC_PORT | 11800 | | - | - | gRPCSslEnabled | Activates SSL for gRPC services. | SWCOREGRPCSSLENABLED | false | | - | - | gRPCSslKeyPath | File path of gRPC SSL key. | SWCOREGRPCSSLKEY_PATH | - | | - | - | gRPCSslCertChainPath | File path of gRPC SSL cert chain. | SWCOREGRPCSSLCERTCHAINPATH | - | | - | - | gRPCSslTrustedCAPath | File path of gRPC trusted CA. | SWCOREGRPCSSLTRUSTEDCAPATH | - | | - | - | downsampling | Activated level of down sampling aggregation. | | Hour,Day | | - | - | enableDataKeeperExecutor | Controller of TTL scheduler. Once disabled, TTL wouldn't work. | SWCOREENABLEDATAKEEPER_EXECUTOR | true | | - | - | dataKeeperExecutePeriod | Execution period of TTL scheduler (in minutes). Execution doesn't mean deleting data. The storage provider (e.g. ElasticSearch storage) could override this. | SWCOREDATAKEEPEREXECUTE_PERIOD | 5 | | - | - | recordDataTTL | The lifecycle of record data (in days). Record data includes traces, top N sample records, and logs. Minimum value is 2. | SWCORERECORDDATATTL | 3 | | - | - | metricsDataTTL | The lifecycle of metrics data (in days), including metadata. We recommend setting metricsDataTTL >= recordDataTTL. Minimum value is 2. | SWCOREMETRICSDATATTL | 7 | | - | - | l1FlushPeriod | The period of L1 aggregation flush to L2 aggregation (in milliseconds). | SWCOREL1AGGREGATIONFLUSH_PERIOD | 500 | | - | - | storageSessionTimeout | The threshold of session time (in milliseconds). Default value is 70000. | SWCORESTORAGESESSIONTIMEOUT | 70000 | | - | - | persistentPeriod | The period of doing data persistence. Unit is second.Default value is 25s | SWCOREPERSISTENT_PERIOD | 25 | | - | - | topNReportPeriod | The execution period (in minutes) of top N sampler, which saves sampled data into the

| SWCORETOPNREPORTPERIOD | 10 | | - | - | activeExtraModelColumns | Appends entity names (e.g. service names) into metrics storage entities. | SWCOREACTIVEEXTRAMODEL_COLUMNS | false | | - | - | serviceNameMaxLength | Maximum length limit of service names. | SWSERVICENAMEMAXLENGTH | 70 | | - | - | instanceNameMaxLength | Maximum length limit of service instance names. The maximum length of service + instance names should be less than 200. | SWINSTANCENAMEMAXLENGTH | 70 | | - | - | endpointNameMaxLength | Maximum length limit of endpoint names. The maximum length of service + endpoint names should be less than 240. | SWENDPOINTNAMEMAXLENGTH | 150 | | - | - | searchableTracesTags | Defines a set of span tag keys which are searchable through GraphQL. Multiple values are separated by commas. The max length of key=value should be less than 256 or will be dropped. | SWSEARCHABLETAGKEYS | http.method,http.statuscode,rpc.status_code,db.type,db.instance,mq.queue,mq.topic,mq.broker | | - | - | searchableLogsTags | Defines a set of log tag keys which are searchable through GraphQL. Multiple values are separated by commas. The max length of key=value should be less than 256 or will be dropped. | SWSEARCHABLELOGSTAGKEYS | level | | - | - | searchableAlarmTags | Defines a set of alarm tag keys which are searchable through GraphQL. Multiple values are separated by commas. The max length of key=value should be less than 256 or will be dropped. | SWSEARCHABLEALARMTAGKEYS | level | | - | - | autocompleteTagKeysQueryMaxSize | The max size of tags keys for autocomplete select. | SWAUTOCOMPLETETAGKEYSQUERYMAXSIZE | 100 | | - | - | autocompleteTagValuesQueryMaxSize | The max size of tags values for autocomplete select. | SWAUTOCOMPLETETAGVALUESQUERYMAXSIZE | 100 | | - | - | gRPCThreadPoolSize | Pool size of gRPC server. | SWCOREGRPCTHREADPOOL_SIZE | Default to gRPC's implementation, which is a cached thread pool that can grow infinitely. | | - | - | maxConcurrentCallsPerConnection | The maximum number of concurrent calls permitted for each incoming connection. Defaults to no limit. | SWCOREGRPCMAXCONCURRENT_CALL | - | | - | - | maxMessageSize | Sets the maximum message size allowed to be received on the server. Empty means 4 MiB. | SWCOREGRPCMAXMESSAGE_SIZE | 4M(based on Netty) | | - | - | remoteTimeout | Timeout for cluster internal communication (in seconds). | - | 20 | | - | - | maxSizeOfNetworkAddressAlias | The maximum size of network address detected in the system being monitored. | - | 1000000 | | - | - | maxPageSizeOfQueryProfileSnapshot | The maximum size for snapshot analysis in an OAP query. | - | 500 | | - | - | maxSizeOfAnalyzeProfileSnapshot | The maximum number of snapshots analyzed by the OAP. | - | 12000 | | - | - | prepareThreads | The number of threads used to prepare metrics data to the storage. | SWCOREPREPARE_THREADS | 2 | | - | - | enableEndpointNameGroupingByOpenapi | Automatically groups endpoints by the given OpenAPI definitions. | SWCOREENABLEENDPOINTNAMEGROUPINGBY_OPENAPI | true | | - | - | maxDurationOfQueryEBPFProfilingData | The maximum duration(in second) of query the eBPF profiling data from database. | - | 30 | | - | - | maxThreadCountOfQueryEBPFProfilingData | The maximum thread count of query the eBPF profiling data from database. | - | System CPU core size | | - | - | uiMenuRefreshInterval | The period(in seconds) of refreshing the status of all UI menu

| - | 20 | | - | - | serviceCacheRefreshInterval | The period(in seconds) of refreshing the service cache. | SWSERVICECACHEREFRESHINTERVAL | 10 | | - | - | enableHierarchy | If disable the hierarchy, the service and instance hierarchy relation will not be built. And the query of hierarchy will return empty result. All the hierarchy relations are defined in the `hierarchy-definition.yml`. Notice: some of the configurations only available for kubernetes environments. | SWCOREENABLE_HIERARCHY | true | | cluster | standalone | - | Standalone is not suitable for running on a single node running. No configuration available. | - | - | | - | zookeeper | namespace | The namespace, represented by root path, isolates the configurations in Zookeeper. | SW_NAMESPACE | `/`, root path | | - | - | hostPort | Hosts and ports of Zookeeper Cluster. | SWCLUSTERZKHOSTPORT | localhost:2181 | | - | - | baseSleepTimeMs | The period of Zookeeper client between two retries (in milliseconds). | SWCLUSTERZKSLEEPTIME | 1000 | | - | - | maxRetries | The maximum retry time. | SWCLUSTERZKMAXRETRIES | 3 | | - | - | enableACL | Opens ACL using `schema` and `expression`. | SWZKENABLE_ACL | false | | - | - | schema | Schema for the authorization. | SWZKSCHEMA | digest | | - | - | expression | Expression for the authorization. | SWZKEXPRESSION | skywalking:skywalking | | - | - | internalComHost | The hostname registered in Zookeeper for the internal communication of OAP cluster. | SWCLUSTERINTERNALCOMHOST | - | | - | - | internalComPort | The port registered in Zookeeper for the internal communication of OAP cluster. | SWCLUSTERINTERNALCOMPORT | -1 | | - | kubernetes | namespace | Namespace deployed by SkyWalking in k8s. | SWCLUSTERK8S_NAMESPACE | default | | - | - | labelSelector | Labels used for filtering OAP deployment in k8s. | SWCLUSTERK8S_LABEL | app=collector,release=skywalking | | - | - | uidEnvName | Environment variable name for reading uid. | SWCLUSTERK8SUID | SKYWALKINGCOLLECTOR_UID | | - | consul | serviceName | Service name for SkyWalking cluster. | SWSERVICENAME | SkyWalkingOAPCluster | | - | - | hostPort | Hosts and ports for Consul cluster. | SWCLUSTERCONSULHOSTPORT | localhost:8500 | | - | - | aclToken | ACL Token of Consul. Empty string means `without ALC token`. | SWCLUSTERCONSUL_ACLTOKEN | - | | - | - | internalComHost | The hostname registered in Consul for internal communications of the OAP cluster. | SWCLUSTERINTERNALCOMHOST | - | | - | - | internalComPort | The port registered in Consul for internal communications of the OAP cluster. | SWCLUSTERINTERNALCOMPORT | -1 | | - | etcd | serviceName | Service name for SkyWalking cluster. | SWCLUSTERETCDSERVICENAME | SkyWalkingOAPCluster | | - | - | endpoints | Hosts and ports for etcd cluster. | SWCLUSTERETCD_ENDPOINTS | localhost:2379 | | - | - | namespace | Namespace for SkyWalking cluster. | SWCLUSTERETCD_NAMESPACE | /skywalking | | - | - | authentication | Indicates whether there is authentication. | SWCLUSTERETCD_AUTHENTICATION | false | | - | - | user | Etcd auth username. | SWCLUSTERETCD_USER | | | - | - | password | Etcd auth password. | SWCLUSTERETCD_PASSWORD | | | - | - | internalComHost | The hostname registered in etcd for internal communications of the OAP cluster. | SWCLUSTERINTERNALCOMHOST | - | | - | - | internalComPort | The port registered in etcd for internal communications of the OAP

| SWCLUSTERINTERNALCOMPORT | -1 | | - | Nacos | serviceName | Service name for SkyWalking cluster. | SWSERVICENAME | SkyWalkingOAPCluster | | - | - | hostPort | Hosts and ports for Nacos cluster. | SWCLUSTERNACOSHOSTPORT | localhost:8848 | | - | - | namespace | Namespace used by SkyWalking node coordination. | SWCLUSTERNACOS_NAMESPACE | public | | - | - | internalComHost | The hostname registered in Nacos for internal communications of the OAP cluster. | SWCLUSTERINTERNALCOMHOST | - | | - | - | internalComPort | The port registered in Nacos for internal communications of the OAP cluster. | SWCLUSTERINTERNALCOMPORT | -1 | | - | - | username | Nacos Auth username. | SWCLUSTERNACOS_USERNAME | - | | - | - | password | Nacos Auth password. | SWCLUSTERNACOS_PASSWORD | - | | - | - | accessKey | Nacos Auth accessKey. | SWCLUSTERNACOS_ACCESSKEY | - | | - | - | secretKey | Nacos Auth secretKey. | SWCLUSTERNACOS_SECRETKEY | - | | - | - | syncPeriodHttpUriRecognitionPattern | The period of HTTP URI recognition pattern synchronization (in seconds). | SWCORESYNCPERIODHTTPURIRECOGNITION_PATTERN | 10 | | - | - | trainingPeriodHttpUriRecognitionPattern | The period of HTTP URI recognition pattern training (in seconds). | SWCORETRAININGPERIODHTTPURIRECOGNITION_PATTERN | 60 | | - | - | maxHttpUrisNumberPerService | The maximum number of HTTP URIs per service. | SWMAXHTTPURISNUMBERPERSERVICE | 3000 | | | storage | elasticsearch | - | ElasticSearch (and OpenSearch) storage implementation. | - | - | | - | - | namespace | Prefix of indexes created and used by SkyWalking. | SW_NAMESPACE | - | | - | - | clusterNodes | ElasticSearch cluster nodes for client connection. | SWSTORAGEESCLUSTERNODES | localhost | | - | - | protocol | HTTP or HTTPs. | SWSTORAGEESHTTPPROTOCOL | HTTP | | - | - | connectTimeout | Connect timeout of ElasticSearch client (in milliseconds). | SWSTORAGEESCONNECTTIMEOUT | 3000 | | - | - | socketTimeout | Socket timeout of ElasticSearch client (in milliseconds). | SWSTORAGEESSOCKETTIMEOUT | 30000 | | - | - | responseTimeout | Response timeout of ElasticSearch client (in milliseconds), `0` disables the timeout. | SWSTORAGEESRESPONSETIMEOUT | 1500 | | - | - | numHttpClientThread | The number of threads for the underlying HTTP client to perform socket I/O. If the value is <= 0, the number of available processors will be used. | SWSTORAGEESNUMHTTPCLIENTTHREAD | 0 | | - | - | user | Username of ElasticSearch cluster. | SWESUSER | - | | - | - | password | Password of ElasticSearch cluster. | SWESPASSWORD | - | | - | - | trustStorePath | Trust JKS file path. Only works when username and password are enabled. | SWSTORAGEESSSLJKS_PATH | - | | - | - | trustStorePass | Trust JKS file password. Only works when username and password are enabled. | SWSTORAGEESSSLJKS_PASS | - | | - | - | secretsManagementFile | Secrets management file in the properties format, including username and password, which are managed by a 3rd party tool. Capable of being updated them at runtime. | SWESSECRETSMANAGEMENTFILE | - | | - | - | dayStep | Represents the number of days in the one-minute/hour/day index. | SWSTORAGEDAY_STEP | 1 | | - | - | indexShardsNumber | Shard number of new indexes. | SWSTORAGEESINDEXSHARDS_NUMBER | 1 | | - | - | indexReplicasNumber | Replicas number of new

| SWSTORAGEESINDEXREPLICAS_NUMBER | 0 | | - | - | specificIndexSettings | Specify the settings for each index individually. If configured, this setting has the highest priority and overrides the generic settings. | SWSTORAGEESSPECIFICINDEX_SETTINGS | - | | - | - | superDatasetDayStep | Represents the number of days in the super size dataset record index. Default value is the same as dayStep when the value is less than 0. | SWSTORAGEESSUPERDATASETDAYSTEP | -1 | | - | - | superDatasetIndexShardsFactor | Super dataset is defined in the code (e.g. trace segments). This factor provides more shards for the super dataset: shards number = indexShardsNumber * superDatasetIndexShardsFactor. This factor also affects Zipkin and Jaeger traces. | SWSTORAGEESSUPERDATASETINDEXSHARDS_FACTOR | 5 | | - | - | superDatasetIndexReplicasNumber | Represents the replicas number in the super size dataset record index. | SWSTORAGEESSUPERDATASETINDEXREPLICAS_NUMBER | 0 | | - | - | indexTemplateOrder | The order of index template. | SWSTORAGEESINDEXTEMPLATE_ORDER | 0 | | - | - | bulkActions | Async bulk size of the record data batch execution. | SWSTORAGEESBULKACTIONS | 5000 | | - | - | batchOfBytes | A threshold to control the max body size of ElasticSearch Bulk flush. | SWSTORAGEESBATCHOF_BYTES | 10485760 (10m) | | - | - | flushInterval | Period of flush (in seconds). Does not matter whether `bulkActions` is reached or not. | SWSTORAGEESFLUSHINTERVAL | 5 | | - | - | concurrentRequests | The number of concurrent requests allowed to be executed. | SWSTORAGEESCONCURRENTREQUESTS | 2 | | - | - | resultWindowMaxSize | The maximum size of dataset when the OAP loads cache, such as network aliases. | SWSTORAGEESQUERYMAXWINDOWSIZE | 10000 | | - | - | metadataQueryMaxSize | The maximum size of metadata per query. | SWSTORAGEESQUERYMAX_SIZE | 10000 | | - | - | scrollingBatchSize | The batch size of metadata per iteration when `metadataQueryMaxSize` or `resultWindowMaxSize` is too large to be retrieved in a single query. | SWSTORAGEESSCROLLINGBATCH_SIZE | 5000 | | - | - | segmentQueryMaxSize | The maximum size of trace segments per query. | SWSTORAGEESQUERYSEGMENT_SIZE | 200 | | - | - | profileTaskQueryMaxSize | The maximum size of profile task per query. | SWSTORAGEESQUERYPROFILETASKSIZE | 200 | | - | - | profileDataQueryScrollBatchSize | The batch size of query profiling data. | SWSTORAGEESQUERYPROFILEDATABATCH_SIZE | 100 | | - | - | advanced | All settings of ElasticSearch index creation. The value should be in JSON format. | SWSTORAGEES_ADVANCED | - | | - | - | logicSharding | Shard metrics and records indices into multi-physical indices, one index template per metric/meter aggregation function or record. | SWSTORAGEESLOGICSHARDING | false | | - | h2 | - | H2 storage is designed for demonstration and running in short term (i.e. 1-2 hours) only. | - | - | | - | - | url | H2 connection URL. Defaults to H2 memory mode. | SWSTORAGEH2_URL | jdbc:h2:mem:skywalking-oap-db | | - | - | user | Username of H2 database. | SWSTORAGEH2_USER | sa | | - | - | password | Password of H2 database. | - | - | | - | - | metadataQueryMaxSize | The maximum size of metadata per

| SWSTORAGEH2QUERYMAX_SIZE | 5000 | | - | - | maxSizeOfBatchSql | The maximum size of batch size of SQL execution | SWSTORAGEMAXSIZEOFBATCHSQL | 100 | | - | - | asyncBatchPersistentPoolSize | async flush data into database thread size | SWSTORAGEASYNCBATCHPERSISTENTPOOLSIZE | 1 | | - | mysql | - | MySQL Storage. The MySQL JDBC Driver is not in the dist. Please copy it into the oap-lib folder manually. | - | - | | - | - | properties | Hikari connection pool configurations. | - | Listed in the `application.yaml`. | | - | - | metadataQueryMaxSize | The maximum size of metadata per query. | SWSTORAGEMYSQLQUERYMAX_SIZE | 5000 | | - | - | maxSizeOfBatchSql | The maximum size of batch size of SQL execution | SWSTORAGEMAXSIZEOFBATCHSQL | 2000 | | - | - | asyncBatchPersistentPoolSize | async flush data into database thread size | SWSTORAGEASYNCBATCHPERSISTENTPOOLSIZE | 4 | | - | postgresql | - | PostgreSQL storage. | - | - | | - | - | properties | Hikari connection pool configurations. | - | Listed in the `application.yaml`. | | - | - | metadataQueryMaxSize | The maximum size of metadata per query. | SWSTORAGEMYSQLQUERYMAX_SIZE | 5000 | | - | - | maxSizeOfBatchSql | The maximum size of batch size of SQL execution | SWSTORAGEMAXSIZEOFBATCHSQL | 2000 | | - | - | asyncBatchPersistentPoolSize | async flush data into database thread size | SWSTORAGEASYNCBATCHPERSISTENTPOOLSIZE | 4 | | - | banyandb | - | BanyanDB storage. | - | - | | - | - | targets | Hosts with ports of the BanyanDB. | SWSTORAGEBANYANDB_TARGETS | 127.0.0.1:17912 | | - | - | maxBulkSize | The maximum size of write entities in a single batch write call. | SWSTORAGEBANYANDBMAXBULK_SIZE | 5000 | | - | - | flushInterval | Period of flush interval. In the timeunit of seconds. | SWSTORAGEBANYANDBFLUSHINTERVAL | 15 | | - | - | metricsShardsNumber | Shards Number for measure/metrics. | SWSTORAGEBANYANDBMETRICSSHARDS_NUMBER | 1 | | - | - | recordShardsNumber | Shards Number for a normal record. | SWSTORAGEBANYANDBRECORDSHARDS_NUMBER | 1 | | - | - | superDatasetShardsFactor | Shards Factor for a super dataset record, i.e. Shard number of a super dataset is recordShardsNumber*superDatasetShardsFactor. | SWSTORAGEBANYANDBSUPERDATASETSHARDS_FACTOR | 2 | | - | - | concurrentWriteThreads | Concurrent consumer threads for batch writing. | SWSTORAGEBANYANDBCONCURRENTWRITE_THREADS | 15 | | - | - | profileTaskQueryMaxSize | Max size of ProfileTask to be fetched. | SWSTORAGEBANYANDBPROFILETASKQUERYMAX_SIZE | 200 | | agent-analyzer | default | Agent Analyzer. | SWAGENTANALYZER | default | | | - | - | traceSamplingPolicySettingsFile | The sampling policy including `sampling rate` and `the threshold of trace segment latency` can be configured by the `traceSamplingPolicySettingsFile` file. | SWTRACESAMPLINGPOLICYSETTINGS_FILE | `trace-sampling-policy-settings.yml` | | - | - | slowDBAccessThreshold | The slow database access threshold (in milliseconds). | SWSLOWDB_THRESHOLD | default:200,mongodb:100 | | - | - | forceSampleErrorSegment | When sampling mechanism is activated, this config samples the error status segment and ignores the sampling rate. | SWFORCESAMPLEERRORSEGMENT | true | | - | - | segmentStatusAnalysisStrategy | Determines the final segment status from span status. Available values are `FROMSPANSTATUS` , `FROMENTRYSPAN`, and `FROMFIRSTSPAN`. `FROMSPANSTATUS` indicates that the segment status would be error if any span has an error status. `FROMENTRYSPAN` means that the segment status would only be determined by the status of entry spans. `FROMFIRSTSPAN` means that the segment status would only be determined by the status of the first

| SWSEGMENTSTATUSANALYSISSTRATEGY | FROMSPANSTATUS | | - | - | noUpstreamRealAddressAgents | Exit spans with the component in the list would not generate client-side instance relation metrics, since some tracing plugins (e.g. Nginx-LUA and Envoy) can't collect the real peer IP address. | SWNOUPSTREAMREALADDRESS | 6000,9000 | | - | - | meterAnalyzerActiveFiles | Indicates which files could be instrumented and analyzed. Multiple files are split by ",". | SWMETERANALYZERACTIVEFILES | | | | - | - | slowCacheWriteThreshold | The threshold of slow command which is used for writing operation (in milliseconds). | SWSLOWCACHEWRITETHRESHOLD | `default:20,redis:10` | | - | - | slowCacheReadThreshold | The threshold of slow command which is used for reading (getting) operation (in milliseconds). | SWSLOWCACHEREADTHRESHOLD | `default:20,redis:10` | | receiver-sharing-server | default | Sharing server provides new gRPC and restful servers for data collection. Ana designates that servers in the core module are to be used for internal communication only. | - | - | | | - | - | restHost | Binding IP of RESTful services. Services include GraphQL query and HTTP data report. | SWRECEIVERSHARINGRESTHOST | - | | - | - | restPort | Binding port of RESTful services. | SWRECEIVERSHARINGRESTPORT | - | | - | - | restContextPath | Web context path of RESTful services. | SWRECEIVERSHARINGRESTCONTEXT_PATH | - | | - | - | restMaxThreads | Maximum thread number of RESTful services. | SWRECEIVERSHARINGRESTMAX_THREADS | 200 | | - | - | restIdleTimeOut | Connector idle timeout of RESTful services (in milliseconds). | SWRECEIVERSHARINGRESTIDLE_TIMEOUT | 30000 | | - | - | restAcceptQueueSize | ServerSocketChannel backlog of RESTful services. | SWRECEIVERSHARINGRESTQUEUE_SIZE | 0 | | - | - | httpMaxRequestHeaderSize | Maximum request header size accepted. | SWRECEIVERSHARINGHTTPMAXREQUESTHEADER_SIZE | 8192 | | - | - | gRPCHost | Binding IP of gRPC services. Services include gRPC data report and internal communication among OAP nodes. | SWRECEIVERGRPC_HOST | 0.0.0.0. Not Activated | | - | - | gRPCPort | Binding port of gRPC services. | SWRECEIVERGRPC_PORT | Not Activated | | - | - | gRPCThreadPoolSize | Pool size of gRPC server. | SWRECEIVERGRPCTHREADPOOL_SIZE | Default to gRPC's implementation, which is a cached thread pool that can grow infinitely. | | - | - | gRPCSslEnabled | Activates SSL for gRPC services. | SWRECEIVERGRPCSSLENABLED | false | | - | - | gRPCSslKeyPath | File path of gRPC SSL key. | SWRECEIVERGRPCSSLKEY_PATH | - | | - | - | gRPCSslCertChainPath | File path of gRPC SSL cert chain. | SWRECEIVERGRPCSSLCERTCHAINPATH | - | | - | - | maxConcurrentCallsPerConnection | The maximum number of concurrent calls permitted for each incoming connection. Defaults to no limit. | SWRECEIVERGRPCMAXCONCURRENT_CALL | - | | - | - | authentication | The token text for authentication. Works for gRPC connection only. Once this is set, the client is required to use the same token. | SW_AUTHENTICATION | - | | log-analyzer | default | Log Analyzer. | SWLOGANALYZER | default | | | - | - | lalFiles | The LAL configuration file names (without file extension) to be activated. Read for more details. | SWLOGLAL_FILES | default | | - | - | malFiles | The MAL configuration file names (without file extension) to be activated. Read for more details. | SWLOGMAL_FILES | "" | | event-analyzer | default | Event Analyzer. | SWEVENTANALYZER | default | | | receiver-register | default | gRPC and HTTPRestful services that provide service, service instance and endpoint

| - | - | | | receiver-trace | default | gRPC and HTTPRestful services that accept SkyWalking format traces. | - | - | | | receiver-jvm | default | gRPC services that accept JVM metrics data. | - | - | | | receiver-clr | default | gRPC services that accept .Net CLR metrics data. | - | - | | | receiver-profile | default | gRPC services that accept profile task status and snapshot reporter. | - | - | | | receiver-zabbix | default | TCP receiver accepts Zabbix format metrics. | - | - | | | - | - | port | Exported TCP port. Zabbix agent could connect and transport data. | SWRECEIVERZABBIX_PORT | 10051 | | - | - | host | Binds to host. | SWRECEIVERZABBIX_HOST | 0.0.0.0 | | - | - | activeFiles | Enables config when agent request is received. | SWRECEIVERZABBIXACTIVEFILES | agent | | service-mesh | default | gRPC services that accept data from inbound mesh probes. | - | - | | | envoy-metric | default | Envoy `metrics_service` and `ALS(access log service)` are supported by this receiver. The OAL script supports all GAUGE type metrics. | - | - | | | - | - | acceptMetricsService | Starts Envoy Metrics Service analysis. | SWENVOYMETRIC_SERVICE | true | | - | - | alsHTTPAnalysis | Starts Envoy HTTP Access Log Service analysis. Value = `k8s-mesh` means starting the analysis. | SWENVOYMETRICALSHTTP_ANALYSIS | - | | - | - | alsTCPAnalysis | Starts Envoy TCP Access Log Service analysis. Value = `k8s-mesh` means starting the analysis. | SWENVOYMETRICALSTCP_ANALYSIS | - | | - | - | k8sServiceNameRule | `k8sServiceNameRule` allows you to customize the service name in ALS via Kubernetes metadata. The available variables are `pod` and `service`. E.g. you can use `${service.metadata.name}-${pod.metadata.labels.version}` to append the version number to the service name. Note that when using environment variables to pass this configuration, use single quotes(`''`) to avoid being evaluated by the shell. | K8SSERVICENAME_RULE | ${pod.metadata.labels.(service.istio.io/canonical-name)}.${pod.metadata.namespace} | | - | - | istioServiceNameRule | `istioServiceNameRule` allows you to customize the service name in ALS via Kubernetes metadata. The available variables are `serviceEntry`. E.g. you can use `${serviceEntry.metadata.name}-${serviceEntry.metadata.labels.version}` to append the version number to the service name. Note that when using environment variables to pass this configuration, use single quotes(`''`) to avoid being evaluated by the shell. | ISTIOSERVICENAME_RULE | ${serviceEntry.metadata.name}.${serviceEntry.metadata.namespace} | | - | - | istioServiceEntryIgnoredNamespaces | When looking up service informations from the Istio ServiceEntries, some of the ServiceEntries might be created in several namespaces automatically by some components, and OAP will randomly pick one of them to build the service name, users can use this config to exclude ServiceEntries that they don't want to be used. Comma separated. | SWISTIOSERVICEENTRYIGNORED_NAMESPACES | - | | - | - | gRPCHost | Binding IP of gRPC service for Envoy access log service. | SWALSGRPC_HOST | 0.0.0.0. Not Activated | | - | - | gRPCPort | Binding port of gRPC service for Envoy access log service. | SWALSGRPC_PORT | Not Activated | | - | - | gRPCThreadPoolSize | Pool size of gRPC server. | SWALSGRPCTHREADPOOL_SIZE | Default to gRPC's implementation, which is a cached thread pool that can grow infinitely. | | - | - | gRPCSslEnabled | Activates SSL for gRPC services. | SWALSGRPCSSLENABLED | false | | - | - | gRPCSslKeyPath | File path of gRPC SSL

| SWALSGRPCSSLKEY_PATH | - | | - | - | gRPCSslCertChainPath | File path of gRPC SSL cert chain. | SWALSGRPCSSLCERTCHAINPATH | - | | - | - | maxConcurrentCallsPerConnection | The maximum number of concurrent calls permitted for each incoming connection. Defaults to no limit. | SWALSGRPCMAXCONCURRENT_CALL | - | | - | - | maxMessageSize | Sets the maximum message size allowed to be received on the server. Empty means 4 MiB. | SWALSGRPCMAXMESSAGE_SIZE | 4M(based on Netty) | | receiver-otel | default | A receiver for analyzing metrics data from OpenTelemetry. | - | - | | | - | - | enabledHandlers | Enabled handlers for otel. | SWOTELRECEIVERENABLEDHANDLERS | - | | - | - | enabledOtelMetricsRules | Enabled metric rules for OTLP handler. | SWOTELRECEIVERENABLEDOTELMETRICSRULES | - | | receiver-zipkin | default | A receiver for Zipkin traces. | - | - | | | - | - | sampleRate | The sample rate precision is 1/10000, should be between 0 and 10000 | SWZIPKINSAMPLE_RATE | 10000 | | - | - | searchableTracesTags | Defines a set of span tag keys which are searchable. Multiple values are separated by commas. The max length of key=value should be less than 256 or will be dropped. | SWZIPKINSEARCHABLETAGKEYS | http.method | | - | - | enableHttpCollector | Enable Http Collector. | SWZIPKINHTTPCOLLECTORENABLED | true | | - | - | restHost | Binding IP of RESTful services. | SWRECEIVERZIPKINRESTHOST | 0.0.0.0 | | - | - | restPort | Binding port of RESTful services. | SWRECEIVERZIPKINRESTPORT | 9411 | | - | - | restContextPath | Web context path of RESTful services. | SWRECEIVERZIPKINRESTCONTEXT_PATH | / | | - | - | restMaxThreads | Maximum thread number of RESTful services. | SWRECEIVERZIPKINRESTMAX_THREADS | 200 | | - | - | restIdleTimeOut | Connector idle timeout of RESTful services (in milliseconds). | SWRECEIVERZIPKINRESTIDLE_TIMEOUT | 30000 | | - | - | restAcceptQueueSize | Maximum request header size accepted. | SWRECEIVERZIPKINRESTQUEUE_SIZE | 0 | | - | - | enableKafkaCollector | Enable Kafka Collector. | SWZIPKINKAFKACOLLECTORENABLED | false | | - | - | kafkaBootstrapServers | Kafka ConsumerConfig.BOOTSTRAPSERVERSCONFIG. | SWZIPKINKAFKA_SERVERS | localhost:9092 | | - | - | kafkaGroupId | Kafka ConsumerConfig.GROUPIDCONFIG. | SWZIPKINKAFKAGROUPID | zipkin | | - | - | kafkaTopic | Kafka Topics. | SWZIPKINKAFKA_TOPIC | zipkin | | - | - | kafkaConsumerConfig | Kafka consumer config, JSON format as Properties. If it contains the same key with above, would override. | SWZIPKINKAFKACONSUMERCONFIG | "{\"auto.offset.reset\":\"earliest\",\"enable.auto.commit\":true}" | | - | - | kafkaConsumers | The number of consumers to create. | SWZIPKINKAFKA_CONSUMERS | 1 | | - | - | kafkaHandlerThreadPoolSize | Pool size of Kafka message handler executor. | SWZIPKINKAFKAHANDLERTHREADPOOLSIZE | CPU core * 2 | | - | - | kafkaHandlerThreadPoolQueueSize | Queue size of Kafka message handler executor. | SWZIPKINKAFKAHANDLERTHREADPOOLQUEUE_SIZE | 10000 | | kafka-fetcher | default | Read SkyWalking's native metrics/logs/traces through Kafka server. | - | - | | | - | - | bootstrapServers | A list of host/port pairs to use for establishing the initial connection to the Kafka cluster. | SWKAFKAFETCHER_SERVERS | localhost:9092 | | - | - | namespace | Namespace aims to isolate multi OAP cluster when using the same Kafka cluster. If you set a namespace for Kafka fetcher, OAP will add a prefix to topic name. You should also set namespace in

The property is named `plugin.kafka.namespace`. | SW_NAMESPACE | - | | - | - | groupId | A unique string that identifies the consumer group to which this consumer belongs. | - | skywalking-consumer | | - | - | partitions | The number of partitions for the topic being created. | SWKAFKAFETCHER_PARTITIONS | 3 | | - | - | consumers | The number of consumers to create. | SWKAFKAFETCHER_CONSUMERS | 1 | | - | - | enableNativeProtoLog | Enables fetching and handling native proto log data. | SWKAFKAFETCHERENABLENATIVEPROTOLOG | true | | - | - | enableNativeJsonLog | Enables fetching and handling native json log data. | SWKAFKAFETCHERENABLENATIVEJSONLOG | true | | - | - | replicationFactor | The replication factor for each partition in the topic being created. | SWKAFKAFETCHERPARTITIONSFACTOR | 2 | | - | - | kafkaHandlerThreadPoolSize | Pool size of Kafka message handler executor. | SWKAFKAHANDLERTHREADPOOL_SIZE | CPU core * 2 | | - | - | kafkaHandlerThreadPoolQueueSize | Queue size of Kafka message handler executor. | SWKAFKAHANDLERTHREADPOOLQUEUESIZE | 10000 | | - | - | topicNameOfMeters | Kafka topic name for meter system data. | - | skywalking-meters | | - | - | topicNameOfMetrics | Kafka topic name for JVM metrics data. | - | skywalking-metrics | | - | - | topicNameOfProfiling | Kafka topic name for profiling data. | - | skywalking-profilings | | - | - | topicNameOfTracingSegments | Kafka topic name for tracing data. | - | skywalking-segments | | - | - | topicNameOfManagements | Kafka topic name for service instance reporting and registration. | - | skywalking-managements | | - | - | topicNameOfLogs | Kafka topic name for native proto log data. | - | skywalking-logs | | - | - | topicNameOfJsonLogs | Kafka topic name for native json log data. | - | skywalking-logs-json | | receiver-browser | default | gRPC services that accept browser performance data and error log. | - | - | - | | - | - | sampleRate | Sampling rate for receiving trace. Precise to 1/10000. 10000 means sampling rate of 100% by default. | SWRECEIVERBROWSERSAMPLERATE | 10000 | | query | graphql | - | GraphQL query implementation. | - | | | - | - | enableLogTestTool | Enable the log testing API to test the LAL. NOTE: This API evaluates untrusted code on the OAP server. A malicious script can do significant damage (steal keys and secrets, remove files and directories, install malware, etc). As such, please enable this API only when you completely trust your users. | SWQUERYGRAPHQLENABLELOGTESTTOOL | false | | - | - | maxQueryComplexity | Maximum complexity allowed for the GraphQL query that can be used to abort a query if the total number of data fields queried exceeds the defined threshold. | SWQUERYMAXQUERYCOMPLEXITY | 3000 | | - | - | enableUpdateUITemplate | Allow user adddisable and update UI template. | SWENABLEUPDATEUITEMPLATE | false | | - | - | enableOnDemandPodLog | Ondemand Pod log: fetch the Pod logs on users' demand, the logs are fetched and displayed in real time, and are not persisted in any kind. This is helpful when users want to do some experiments and monitor the logs and see what's happing inside the

Note: if you print secrets in the logs, they are also visible to the UI, so for the sake of security, this feature is disabled by default, please set this configuration to enable the feature manually. | SWENABLEONDEMANDPOD_LOG | false | | query-zipkin | default | - | This module is for Zipkin query API and support zipkin-lens UI | - | | | - | - | restHost | Binding IP of RESTful services. | SWQUERYZIPKINRESTHOST | 0.0.0.0 | | - | - | restPort | Binding port of RESTful services. | SWQUERYZIPKINRESTPORT | 9412 | | - | - | restContextPath | Web context path of RESTful services. | SWQUERYZIPKINRESTCONTEXT_PATH | zipkin | | - | - | restMaxThreads | Maximum thread number of RESTful services. | SWQUERYZIPKINRESTMAX_THREADS | 200 | | - | - | restIdleTimeOut | Connector idle timeout of RESTful services (in milliseconds). | SWQUERYZIPKINRESTIDLE_TIMEOUT | 30000 | | - | - | restAcceptQueueSize | Maximum request header size accepted. | SWQUERYZIPKINRESTQUEUE_SIZE | 0 | | - | - | lookback | Default look back for traces and autocompleteTags, 1 day in millis | SWQUERYZIPKIN_LOOKBACK | 86400000 | | - | - | namesMaxAge | The Cache-Control max-age (seconds) for serviceNames, remoteServiceNames and spanNames | SWQUERYZIPKINNAMESMAX_AGE | 300 | | - | - | uiQueryLimit | Default traces query max size | SWQUERYZIPKINUIQUERY_LIMIT | 10 | | - | - | uiDefaultLookback | Default look back on the UI for search traces, 15 minutes in millis | SWQUERYZIPKINUIDEFAULT_LOOKBACK | 900000 | | promql | default | - | This module is for PromQL API. | - | | | - | - | restHost | Binding IP of RESTful services. | SWPROMQLREST_HOST | 0.0.0.0 | | - | - | restPort | Binding port of RESTful services. | SWPROMQLREST_PORT | 9090 | | - | - | restContextPath | Web context path of RESTful services. | SWPROMQLRESTCONTEXTPATH | / | | - | - | restMaxThreads | Maximum thread number of RESTful services. | SWPROMQLRESTMAXTHREADS | 200 | | - | - | restIdleTimeOut | Connector idle timeout of RESTful services (in milliseconds). | SWPROMQLRESTIDLETIMEOUT | 30000 | | - | - | restAcceptQueueSize | Maximum request header size accepted. | SWPROMQLRESTQUEUESIZE | 0 | | - | - | buildInfoVersion | Mock version for API buildInfo | SWPROMQLBUILDINFOVERSION | 2.45.0 | | - | - | buildInfoRevision | Mock revision for API buildInfo | SWPROMQLBUILDINFOREVISION | | | - | - | buildInfoBranch | Mock branch for API buildInfo | SWPROMQLBUILDINFOBRANCH | | | - | - | buildInfoBuildUser | Mock build user for API buildInfo | SWPROMQLBUILDINFOBUILD_USER | | | - | - | buildInfoBuildDate | Mock build date for API buildInfo | SWPROMQLBUILDINFOBUILD_DATE | | | - | - | buildInfoGoVersion | Mock go version for API buildInfo | SWPROMQLBUILDINFOGO_VERSION | | | alarm | default | - | Read for more details. | - | | | telemetry | - | - | Read for more details. | - | | | - | none | - | No op implementation. | - | | | - | prometheus | host | Binding host for Prometheus server fetching data. | SWTELEMETRYPROMETHEUS_HOST | 0.0.0.0 | | - | - | port | Binding port for Prometheus server fetching data. | SWTELEMETRYPROMETHEUS_PORT | 1234 | | configuration | - | - | Read for more details. | - | | | - | grpc | host | DCS server binding

| SWDCSSERVER_HOST | - | | - | - | port | DCS server binding port. | SWDCSSERVER_PORT | 80 | | - | - | clusterName | Cluster name when reading the latest configuration from DSC server. | SWDCSCLUSTER_NAME | SkyWalking | | - | - | period | The period of reading data from DSC server by the OAP (in seconds). | SWDCSPERIOD | 20 | | - | - | maxInboundMessageSize | The max inbound message size of gRPC. | SWDCSMAXINBOUNDMESSAGE_SIZE | 4194304 | | - | apollo | apolloMeta | `apollo.meta` in Apollo. | SWCONFIGAPOLLO | http://localhost:8080 | | - | - | apolloCluster | `apollo.cluster` in Apollo. | SWCONFIGAPOLLO_CLUSTER | default | | - | - | apolloEnv | `env` in Apollo. | SWCONFIGAPOLLO_ENV | - | | - | - | appId | `app.id` in Apollo. | SWCONFIGAPOLLOAPPID | skywalking | | - | zookeeper | namespace | The namespace (represented by root path) that isolates the configurations in the Zookeeper. | SWCONFIGZK_NAMESPACE | `/`, root path | | - | - | hostPort | Hosts and ports of Zookeeper Cluster. | SWCONFIGZKHOSTPORT | localhost:2181 | | - | - | baseSleepTimeMs | The period of Zookeeper client between two retries (in milliseconds). | SWCONFIGZKBASESLEEPTIMEMS | 1000 | | - | - | maxRetries | The maximum retry time. | SWCONFIGZKMAXRETRIES | 3 | | - | - | period | The period of data sync (in seconds). | SWCONFIGZK_PERIOD | 60 | | - | etcd | endpoints | Hosts and ports for etcd cluster (separated by commas if multiple). | SWCONFIGETCD_ENDPOINTS | http://localhost:2379 | | - | - | namespace | Namespace for SkyWalking cluster. | SWCONFIGETCD_NAMESPACE | /skywalking | | - | - | authentication | Indicates whether there is authentication. | SWCONFIGETCD_AUTHENTICATION | false | | - | - | user | Etcd auth username. | SWCONFIGETCD_USER | | | - | - | password | Etcd auth password. | SWCONFIGETCD_PASSWORD | | | - | - | period | The period of data sync (in seconds). | SWCONFIGZK_PERIOD | 60 | | - | consul | hostPort | Hosts and ports for Consul cluster. | SWCONFIGCONSULHOSTAND_PORTS | localhost:8500 | | - | - | aclToken | ACL Token of Consul. Empty string means `without ACL token`. | SWCONFIGCONSULACLTOKEN | - | | - | - | period | The period of data sync (in seconds). | SWCONFIGCONSUL_PERIOD | 60 | | - | k8s-configmap | namespace | Deployment namespace of the config map. | SWCLUSTERK8S_NAMESPACE | default | | - | - | labelSelector | Labels for locating configmap. | SWCLUSTERK8S_LABEL | app=collector,release=skywalking | | - | - | period | The period of data sync (in seconds). | SWCONFIGZK_PERIOD | 60 | | - | nacos | serverAddr | Nacos Server Host. | SWCONFIGNACOSSERVERADDR | 127.0.0.1 | | - | - | port | Nacos Server Port. | SWCONFIGNACOSSERVERPORT | 8848 | | - | - | group | Nacos Configuration namespace. | SWCONFIGNACOSSERVERNAMESPACE | - | | - | - | period | The period of data sync (in seconds). | SWCONFIGCONFIGNACOSPERIOD | 60 | | - | - | username | Nacos Auth username. | SWCONFIGNACOS_USERNAME | - | | - | - | password | Nacos Auth password. | SWCONFIGNACOS_PASSWORD | - | | - | - | accessKey | Nacos Auth

| SWCONFIGNACOS_ACCESSKEY | - | | - | - | secretKey | Nacos Auth secretKey. | SWCONFIGNACOS_SECRETKEY | - | | exporter | default | enableGRPCMetrics | Enable gRPC metrics exporter. | SWEXPORTERENABLEGRPCMETRICS | false | | - | - | gRPCTargetHost | The host of target gRPC server for receiving export data | SWEXPORTERGRPC_HOST | 127.0.0.1 | | - | - | gRPCTargetPort | The port of target gRPC server for receiving export data. | SWEXPORTERGRPC_PORT | 9870 | | - | - | enableKafkaTrace | Enable Kafka trace exporter. | SWEXPORTERENABLEKAFKATRACE | false | | - | - | enableKafkaLog | Enable Kafka log exporter. | SWEXPORTERENABLEKAFKALOG | false | | - | - | kafkaBootstrapServers | A list of host/port pairs to use for establishing the initial connection to the Kafka cluster. | SWEXPORTERKAFKA_SERVERS | localhost:9092 | | - | - | kafkaProducerConfig | Kafka producer config, JSON format as Properties. | SWEXPORTERKAFKAPRODUCERCONFIG | - | | - | - | kafkaTopicTrace | Kafka topic name for trace. | SWEXPORTERKAFKATOPICTRACE | skywalking-export-trace | | - | - | kafkaTopicLog | Kafka topic name for log. | SWEXPORTERKAFKATOPICLOG | skywalking-export-log | | - | - | exportErrorStatusTraceOnly | Export error status trace segments through the Kafka channel. | SWEXPORTERKAFKATRACEFILTER_ERROR | false | | health-checker | default | checkIntervalSeconds | The period of checking OAP internal health status (in seconds). | SWHEALTHCHECKERINTERVALSECONDS | 5 | | debugging-query | default | | | | | | - | - | keywords4MaskingSecretsOfConfig | Include the list of keywords to filter configurations including secrets. Separate keywords by a comma. | SWDEBUGGINGQUERYKEYWORDSFORMASKINGSECRETS | user,password,token,accessKey,secretKey,authentication | | configuration-discovery | default | disableMessageDigest | If true, agent receives the latest configuration every time, even without making any changes. By default, OAP uses the SHA512 message digest mechanism to detect changes in configuration. | SWDISABLEMESSAGE_DIGEST | false | | receiver-event | default | gRPC services that handle events data. | - | - | | | aws-firehose-receiver | default | host | Binding IP of HTTP server | SWRECEIVERAWSFIREHOSEHTTP_HOST | 0.0.0.0 | | - | - | port | Binding port of HTTP server | SWRECEIVERAWSFIREHOSEHTTP_PORT | 12801 | | - | - | contextPath | Context path of HTTP server | SWRECEIVERAWSFIREHOSEHTTPCONTEXTPATH | / | | - | - | maxThreads | Max Thtread number of HTTP server | SWRECEIVERAWSFIREHOSEHTTPMAXTHREADS | 200 | | - | - | idleTimeOut | Idle timeout of a connection for keep-alive. | SWRECEIVERAWSFIREHOSEHTTPIDLETIME_OUT | 30000 | | - | - | acceptQueueSize | Maximum allowed number of open connections | SWRECEIVERAWSFIREHOSEHTTPACCEPTQUEUE_SIZE | 0 | | - | - | maxRequestHeaderSize | Maximum length of all headers in an HTTP/1 response | SWRECEIVERAWSFIREHOSEHTTPMAXREQUESTHEADERSIZE | 8192 | | - | - | firehoseAccessKey | The AccessKey of AWS firhose | SWRECEIVERAWSFIREHOSEACCESS_KEY | | | - | - | enableTLS | Indicate if enable HTTPS for the server | SWRECEIVERAWSFIREHOSEHTTPENABLETLS | false | | - | - | tlsKeyPath | TLS key path | SWRECEIVERAWSFIREHOSEHTTPTLSKEY_PATH | | | - | - | tlsCertChainPath | TLS certificate chain path | SWRECEIVERAWSFIREHOSEHTTPTLSCERTCHAINPATH | | | ai-pipeline | default | | | | | - | - | uriRecognitionServerAddr | The address of the URI recognition server. | SWAIPIPELINEURIRECOGNITIONSERVERADDR | - | | - | - | uriRecognitionServerPort | The port of the URI recognition server. | SWAIPIPELINEURIRECOGNITIONSERVERPORT | 17128 | System Environment Variable name could be declared and changed in `application.yml`. The names listed here are simply provided in the default `application.yml` file.