产品定价 立即试用
专业版
社区版 专业版 云平台 边缘 PE边缘 IoT网关 许可证服务器 Trendz Analytics 移动应用 PE移动应用 MQTT Broker PE MQTT Broker
安装 > 配置 > 集成执行器参数
入门 文档 指南
架构 API 常见问题
目录

集成执行器参数

服务端通用参数

参数环境变量默认值描述
server.address HTTP_BIND_ADDRESS 0.0.0.0 服务器绑定地址
server.port HTTP_BIND_PORT 8082 服务器绑定端口
server.tomcat.max-http-form-post-size MAX_HTTP_FORM_POST_SIZE 10000000 10Mb

Spring通用参数

参数环境变量默认值描述
spring.main.allow-circular-references "true" Spring Boot配置属性控制是否允许bean之间的循环依赖。
spring.servlet.multipart.max-file-size SPRING_SERVLET_MULTIPART_MAX_FILE_SIZE 50MB 配置文件上传时总文件大小不能超过50MB
spring.servlet.multipart.max-request-size SPRING_SERVLET_MULTIPART_MAX_REQUEST_SIZE 50MB multipart/form-data的总请求大小不能超过50MB

Zookeeper连接参数（用于服务发现）

参数环境变量默认值描述
zk.enabled ZOOKEEPER_ENABLED true 启用/禁用Zookeeper服务发现。用于ThingsBoard集群
zk.url ZOOKEEPER_URL localhost:2181 Zookeeper连接字符串
zk.retry_interval_ms ZOOKEEPER_RETRY_INTERVAL_MS 3000 Zookeeper重试间隔（毫秒）
zk.connection_timeout_ms ZOOKEEPER_CONNECTION_TIMEOUT_MS 3000 Zookeeper连接超时（毫秒）
zk.session_timeout_ms ZOOKEEPER_SESSION_TIMEOUT_MS 3000 Zookeeper会话超时（毫秒）
zk.zk_dir ZOOKEEPER_NODES_DIR /thingsboard Zookeeper'文件系统'中的目录名
zk.recalculate_delay ZOOKEEPER_RECALCULATE_DELAY_MS 0 建议在规则引擎服务的微服务架构设置中使用recalculate_delay属性。此属性提供暂停，以确保重新启动规则引擎服务时，其他节点不会立即尝试重新计算其分区。建议延迟，因为规则链参与者的初始化非常耗时。避免重新启动期间不必要的重新计算可以增强系统性能和稳定性。

集成通用参数

参数环境变量默认值描述
integrations.statistics.enabled INTEGRATIONS_STATISTICS_ENABLED true 启用/禁用集成统计功能
integrations.statistics.persist_frequency INTEGRATIONS_STATISTICS_PERSIST_FREQUENCY 3600000 集成统计数据持久化频率（毫秒）
integrations.init.connection_timeout_sec INTEGRATIONS_INIT_CONNECTION_TIMEOUT_SEC 10 集成连接允许的最大超时时间（秒）。用户配置若超过此值，将自动降至该上限。
integrations.init.connection_check_api_request_timeout_sec INTEGRATIONS_INIT_CONNECTION_CHECK_API_REQUEST_TIMEOUT_SEC 20 API请求连接检查超时时间（秒）
integrations.reinit.enabled INTEGRATIONS_REINIT_ENABLED true 启用/禁用集成热重初始化
integrations.reinit.frequency INTEGRATIONS_REINIT_FREQUENCY 300000 检查并重新初始化集成的间隔
integrations.allow_Local_network_hosts INTEGRATIONS_ALLOW_LOCAL_NETWORK_HOSTS true 启用/禁用集成本地网络主机访问

队列通用参数

参数环境变量默认值描述
queue.type TB_QUEUE_TYPE kafka 卡夫卡（阿帕奇·卡夫卡）
queue.prefix TB_QUEUE_PREFIX 全局队列前缀。若指定，则在默认topic名前添加：'prefix.default_topic_name'。应用于所有topic（及kafka consumer group）。
queue.kafka.bootstrap.servers TB_KAFKA_SERVERS localhost:9092 Kafka Bootstrap服务器
queue.kafka.ssl.enabled TB_KAFKA_SSL_ENABLED false 启用/禁用Kafka SSL通信
queue.kafka.ssl.truststore.location TB_KAFKA_SSL_TRUSTSTORE_LOCATION truststore文件路径
queue.kafka.ssl.truststore.password TB_KAFKA_SSL_TRUSTSTORE_PASSWORD 若指定了truststore则为其密码
queue.kafka.ssl.keystore.location TB_KAFKA_SSL_KEYSTORE_LOCATION keystore文件路径。客户端可选，用于客户端双向认证
queue.kafka.ssl.keystore.password TB_KAFKA_SSL_KEYSTORE_PASSWORD 密钥存储文件的存储密码。这对于客户端来说是可选的，并且仅在配置了“ssl.keystore.location”时才需要。PEM格式不支持密钥存储密码
queue.kafka.ssl.key.password TB_KAFKA_SSL_KEY_PASSWORD 密钥库文件中私钥的密码或“keystore.key”中指定的PEM密钥的密码
queue.kafka.acks TB_KAFKA_ACKS all 生产者认为请求完成前要求leader收到的确认数。控制发送记录的持久性。允许值：0、1、all
queue.kafka.retries TB_KAFKA_RETRIES 1 重试次数。重发因瞬时错误发送失败的记录
queue.kafka.compression.type TB_KAFKA_COMPRESSION_TYPE none none或gzip
queue.kafka.batch.size TB_KAFKA_BATCH_SIZE 16384 默认批量大小。为待发送批量的上限
queue.kafka.linger.ms TB_KAFKA_LINGER_MS 1 创建少许人工延迟，即不立即发送记录
queue.kafka.max.request.size TB_KAFKA_MAX_REQUEST_SIZE 1048576 单次请求最大字节数。限制生产者单次请求发送的批次数以避免发送过大请求
queue.kafka.max.in.flight.requests.per.connection TB_KAFKA_MAX_IN_FLIGHT_REQUESTS_PER_CONNECTION 5 客户端在单连接上阻塞前可发送的未确认请求最大数
queue.kafka.buffer.memory TB_BUFFER_MEMORY 33554432 生产者用于缓冲待发送记录的内存总字节数
queue.kafka.replication_factor TB_QUEUE_KAFKA_REPLICATION_FACTOR 1 Kafka多broker上的数据副本数
queue.kafka.max_poll_interval_ms TB_QUEUE_KAFKA_MAX_POLL_INTERVAL_MS 300000 使用consumer group管理时两次poll()调用间的最大延迟。限制消费者在获取更多记录前可空闲的最长时间
queue.kafka.max_poll_records TB_QUEUE_KAFKA_MAX_POLL_RECORDS 8192 单次poll()调用返回的最大记录数
queue.kafka.max_partition_fetch_bytes TB_QUEUE_KAFKA_MAX_PARTITION_FETCH_BYTES 16777216 服务器每分区返回的最大数据量。消费者按批获取记录
queue.kafka.fetch_max_bytes TB_QUEUE_KAFKA_FETCH_MAX_BYTES 134217728 服务器返回的最大数据量。消费者按批获取记录
queue.kafka.request.timeout.ms TB_QUEUE_KAFKA_REQUEST_TIMEOUT_MS 30000 (30秒)
queue.kafka.session.timeout.ms TB_QUEUE_KAFKA_SESSION_TIMEOUT_MS 10000 (10秒)
queue.kafka.use_confluent_cloud TB_QUEUE_KAFKA_USE_CONFLUENT_CLOUD false 启用/禁用Confluent Cloud
queue.kafka.confluent.ssl.algorithm TB_QUEUE_KAFKA_CONFLUENT_SSL_ALGORITHM https 客户端验证服务器主机名的端点标识算法。默认https
queue.kafka.confluent.sasl.mechanism TB_QUEUE_KAFKA_CONFLUENT_SASL_MECHANISM PLAIN 认证Schema Registry请求的机制。SASL/PLAIN应仅与TLS/SSL传输层配合使用以确保明文密码不未加密传输
queue.kafka.confluent.sasl.config TB_QUEUE_KAFKA_CONFLUENT_SASL_JAAS_CONFIG org.apache.kafka.common.security.plain.PlainLoginModule required username=\"CLUSTER_API_KEY\" password=\"CLUSTER_API_SECRET\"; 使用JAAS配置指定broker上的多个SASL机制
queue.kafka.confluent.security.protocol TB_QUEUE_KAFKA_CONFLUENT_SECURITY_PROTOCOL SASL_SSL 与broker通信的协议。有效值：PLAINTEXT、SSL、SASL_PLAINTEXT、SASL_SSL
queue.kafka.consumer-properties-per-topic.tb_ota_package.key max.poll.records 每个特定主题的Kafka消费者的键值属性，例如tb_ota_package是ota的主题名称，tb_rule_engine.sq是默认SequentialByOriginator队列的主题名称。检查TB_QUEUE_CORE_OTA_TOPIC和TB_QUEUE_RE_SQ_TOPIC参数
queue.kafka.consumer-properties-per-topic.tb_ota_package.key.value TB_QUEUE_KAFKA_OTA_MAX_POLL_RECORDS 10 每个主题的特定消费者属性值示例
queue.kafka.consumer-properties-per-topic-inline TB_QUEUE_KAFKA_CONSUMER_PROPERTIES_PER_TOPIC_INLINE tb_rule_engine.sq: - key: max.poll.records value: "${TB_QUEUE_KAFKA_SQ_MAX_POLL_RECORDS:1024}"如果使用环境变量覆盖任何默认的Kafka主题名称，则还必须在 `consumer-properties-per-topic-inline` 中指定新主题的相关消费者属性。否则，主题将不会继承其预期配置（例如max.poll.records、超时等）。格式：“topic1:key1=value1,key2=value2;topic2:key=value” 示例：“tb_core_modified.notifications:max.poll.records=10;tb_edge_modified:max.poll.records=10,enable.auto.commit=true”
queue.kafka.other-inline TB_QUEUE_KAFKA_OTHER_PROPERTIES 在本节中，您可以为Kafka消费者/生产者/管理员指定自定义参数（分号分隔）
queue.kafka.topic-properties.rule-engine TB_QUEUE_KAFKA_RE_TOPIC_PROPERTIES retention.ms:604800000;segment.bytes:52428800;retention.bytes:1048576000;partitions:1;min.insync.replicas:1 规则引擎的Kafka属性
queue.kafka.topic-properties.core TB_QUEUE_KAFKA_CORE_TOPIC_PROPERTIES retention.ms:604800000;segment.bytes:52428800;retention.bytes:1048576000;partitions:1;min.insync.replicas:1 Core topic的Kafka属性
queue.kafka.topic-properties.transport-api TB_QUEUE_KAFKA_TA_TOPIC_PROPERTIES retention.ms:604800000;segment.bytes:52428800;retention.bytes:1048576000;partitions:10;min.insync.replicas:1 Transport Api topic的Kafka属性
queue.kafka.topic-properties.notifications TB_QUEUE_KAFKA_NOTIFICATIONS_TOPIC_PROPERTIES retention.ms:604800000;segment.bytes:52428800;retention.bytes:1048576000;partitions:1;min.insync.replicas:1 通知topic的Kafka属性
queue.kafka.topic-properties.js-executor TB_QUEUE_KAFKA_JE_TOPIC_PROPERTIES retention.ms:604800000;segment.bytes:52428800;retention.bytes:104857600;partitions:100;min.insync.replicas:1 JS执行器主题的Kafka属性
queue.kafka.topic-properties.integration-api TB_QUEUE_KAFKA_INTEGRATION_TOPIC_PROPERTIES retention.ms:604800000;segment.bytes:52428800;retention.bytes:1048576000;partitions:10;min.insync.replicas:1 Kafka properties for Integration Api topics
queue.kafka.topic-properties.housekeeper TB_QUEUE_KAFKA_HOUSEKEEPER_TOPIC_PROPERTIES retention.ms:604800000;segment.bytes:52428800;retention.bytes:1048576000;partitions:10;min.insync.replicas:1 Housekeeper任务topic的Kafka属性
queue.kafka.consumer-stats.enabled TB_QUEUE_KAFKA_CONSUMER_STATS_ENABLED true 打印Kafka主题中消费者组偏移量和最后消息偏移量之间的滞后
queue.kafka.consumer-stats.print-interval-ms TB_QUEUE_KAFKA_CONSUMER_STATS_MIN_PRINT_INTERVAL_MS 60000 Kafka消费者组统计数据的统计打印间隔
queue.kafka.consumer-stats.kafka-response-timeout-ms TB_QUEUE_KAFKA_CONSUMER_STATS_RESPONSE_TIMEOUT_MS 1000 等待Kafka的统计数据加载请求完成的时间
queue.kafka.topics_cache_ttl_ms TB_QUEUE_KAFKA_TOPICS_CACHE_TTL_MS 300000 topic缓存TTL（毫秒）。默认5分钟
queue.partitions.hash_function_name TB_QUEUE_PARTITIONS_HASH_FUNCTION_NAME murmur3_128 murmur3_32、murmur3_128或sha256
queue.transport_api.requests_topic TB_QUEUE_TRANSPORT_API_REQUEST_TOPIC tb_transport.api.requests 消费传输微服务api请求的topic
queue.transport_api.responses_topic TB_QUEUE_TRANSPORT_API_RESPONSE_TOPIC tb_transport.api.responses 向传输微服务发送api响应的topic
queue.transport_api.max_pending_requests TB_QUEUE_TRANSPORT_MAX_PENDING_REQUESTS 10000 服务器待处理的传输微服务api请求最大数
queue.transport_api.max_requests_timeout TB_QUEUE_TRANSPORT_MAX_REQUEST_TIMEOUT 10000 服务器处理传输微服务api请求的最大超时（毫秒）
queue.transport_api.max_callback_threads TB_QUEUE_TRANSPORT_MAX_CALLBACK_THREADS 100 用于调用回调的线程数
queue.transport_api.request_poll_interval TB_QUEUE_TRANSPORT_REQUEST_POLL_INTERVAL_MS 25 轮询传输微服务api请求的间隔（毫秒）
queue.transport_api.response_poll_interval TB_QUEUE_TRANSPORT_RESPONSE_POLL_INTERVAL_MS 25 轮询传输微服务api响应的间隔（毫秒）
queue.core.topic TB_QUEUE_CORE_TOPIC tb_core 默认topic名
queue.core.notifications_topic TB_QUEUE_CORE_NOTIFICATIONS_TOPIC tb_core.notifications 需要最低延迟和处理时间的高优先级通知
queue.core.poll-interval TB_QUEUE_CORE_POLL_INTERVAL_MS 25 Core微服务轮询消息的间隔（毫秒）
queue.core.partitions TB_QUEUE_CORE_PARTITIONS 10 Core微服务使用的分区数
queue.core.pack-processing-timeout TB_QUEUE_CORE_PACK_PROCESSING_TIMEOUT_MS 2000 Core微服务处理消息包的超时
queue.core.ota.topic TB_QUEUE_CORE_OTA_TOPIC tb_ota_package 默认topic名for OTA updates
queue.core.ota.pack-interval-ms TB_QUEUE_CORE_OTA_PACK_INTERVAL_MS 60000 处理设备OTA更新的时间间隔。用于避免由于许多并行OTA更新而对网络造成任何损害
queue.core.ota.pack-size TB_QUEUE_CORE_OTA_PACK_SIZE 100 从队列中获取的OTA更新通知的大小。队列存储成对的固件和设备ID
queue.core.usage-stats-topic TB_QUEUE_US_TOPIC tb_usage_stats 统计主题名称
queue.core.stats.enabled TB_QUEUE_CORE_STATS_ENABLED true 启用/禁用Core微服务统计
queue.core.stats.print-interval-ms TB_QUEUE_CORE_STATS_PRINT_INTERVAL_MS 60000 Core微服务统计打印间隔
queue.core.housekeeper.topic TB_HOUSEKEEPER_TOPIC tb_housekeeper Housekeeper任务topic名
queue.js.request_topic REMOTE_JS_EVAL_REQUEST_TOPIC js_eval.requests JS Eval请求topic
queue.js.response_topic_prefix REMOTE_JS_EVAL_RESPONSE_TOPIC js_eval.responses 与节点id组合的JS Eval响应topic前缀
queue.js.max_pending_requests REMOTE_JS_MAX_PENDING_REQUESTS 10000 JS Eval最大待处理请求数
queue.js.max_eval_requests_timeout REMOTE_JS_MAX_EVAL_REQUEST_TIMEOUT 60000 JS Eval最大请求超时
queue.js.max_requests_timeout REMOTE_JS_MAX_REQUEST_TIMEOUT 10000 JS Eval最大请求超时
queue.js.response_poll_interval REMOTE_JS_RESPONSE_POLL_INTERVAL_MS 25 JS响应轮询间隔
queue.rule-engine.topic TB_QUEUE_RULE_ENGINE_TOPIC tb_rule_engine 已弃用。将在近期版本中移除
queue.rule-engine.notifications_topic TB_QUEUE_RULE_ENGINE_NOTIFICATIONS_TOPIC tb_rule_engine.notifications 需要最低延迟和处理时间的高优先级通知
queue.rule-engine.poll-interval TB_QUEUE_RULE_ENGINE_POLL_INTERVAL_MS 25 规则引擎轮询消息的间隔（毫秒）
queue.rule-engine.pack-processing-timeout TB_QUEUE_RULE_ENGINE_PACK_PROCESSING_TIMEOUT_MS 2000 规则引擎处理消息包的超时
queue.rule-engine.stats.enabled TB_QUEUE_RULE_ENGINE_STATS_ENABLED true 启用/禁用规则引擎统计
queue.rule-engine.stats.print-interval-ms TB_QUEUE_RULE_ENGINE_STATS_PRINT_INTERVAL_MS 60000 规则引擎统计打印间隔
queue.rule-engine.queues.name TB_QUEUE_RE_SQ_QUEUE_NAME SequentialByOriginator queue name
queue.rule-engine.queues.name.topic TB_QUEUE_RE_SQ_TOPIC tb_rule_engine.sq queue topic
queue.rule-engine.queues.name.poll-interval TB_QUEUE_RE_SQ_POLL_INTERVAL_MS 25 poll interval
queue.rule-engine.queues.name.partitions TB_QUEUE_RE_SQ_PARTITIONS 10 number queue partitions
queue.rule-engine.queues.name.consumer-per-partition TB_QUEUE_RE_SQ_CONSUMER_PER_PARTITION true if true - use for each customer different partition
queue.rule-engine.queues.name.pack-processing-timeout TB_QUEUE_RE_SQ_PACK_PROCESSING_TIMEOUT_MS 2000 Timeout for processing a message pack
queue.rule-engine.queues.name.submit-strategy.type TB_QUEUE_RE_SQ_SUBMIT_STRATEGY_TYPE SEQUENTIAL_BY_ORIGINATOR BURST, BATCH, SEQUENTIAL_BY_ORIGINATOR, SEQUENTIAL_BY_TENANT, SEQUENTIAL
queue.rule-engine.queues.name.submit-strategy.batch-size TB_QUEUE_RE_SQ_SUBMIT_STRATEGY_BATCH_SIZE 100 Maximum number of messages in batch
queue.rule-engine.queues.name.processing-strategy.type TB_QUEUE_RE_SQ_PROCESSING_STRATEGY_TYPE RETRY_FAILED_AND_TIMED_OUT SKIP_ALL_FAILURES, SKIP_ALL_FAILURES_AND_TIMED_OUT, RETRY_ALL, RETRY_FAILED, RETRY_TIMED_OUT, RETRY_FAILED_AND_TIMED_OUT
queue.rule-engine.queues.name.processing-strategy.retries TB_QUEUE_RE_SQ_PROCESSING_STRATEGY_RETRIES 3 Number of retries, 0 is unlimited
queue.rule-engine.queues.name.processing-strategy.failure-percentage TB_QUEUE_RE_SQ_PROCESSING_STRATEGY_FAILURE_PERCENTAGE 0 Skip retry if failures or timeouts are less then X percentage of messages;
queue.rule-engine.queues.name.processing-strategy.pause-between-retries TB_QUEUE_RE_SQ_PROCESSING_STRATEGY_RETRY_PAUSE 5 Time in seconds to wait in consumer thread before retries;
queue.rule-engine.queues.name.processing-strategy.max-pause-between-retries TB_QUEUE_RE_SQ_PROCESSING_STRATEGY_MAX_RETRY_PAUSE 5 Max allowed time in seconds for pause between retries.
queue.integration.partitions TB_QUEUE_INTEGRATION_PARTITIONS 3 Name of hash function used for consistent hash ring in Cluster Mode. See architecture docs for more details. Valid values - murmur3_32, murmur3_128 or sha256
queue.integration.notifications_topic TB_QUEUE_INTEGRATION_NOTIFICATIONS_TOPIC tb_integration_executor.notifications For high-priority notifications that require minimum latency and processing time
queue.integration.downlink_topic TB_QUEUE_INTEGRATION_DOWNLINK_TOPIC tb_ie.downlink Default downlink topic name used by queue
queue.integration.downlink_topics TB_QUEUE_INTEGRATION_DOWNLINK_TOPICS Downlink topic names for integration type (semicolor separated). Example: "MQTT:tb_ie.downlink.mqtt,HTTP:tb_ie.downlink.http" If not specified, the default topic will construct as before - 'downlink_topic' + IntegrationType.name()
queue.integration.uplink_topic TB_QUEUE_INTEGRATION_UPLINK_TOPIC tb_ie.uplink Default uplink topic name used by queue
queue.integration.poll_interval TB_QUEUE_INTEGRATION_POLL_INTERVAL_MS 25 Interval in milliseconds to poll messages by integrations
queue.integration.pack-processing-timeout TB_QUEUE_INTEGRATION_PACK_PROCESSING_TIMEOUT_MS 10000 Timeout for processing a message pack by integrations
queue.integration_api.requests_topic TB_QUEUE_INTEGRATION_EXECUTOR_API_REQUEST_TOPIC tb_ie.api.requests Default Integration Api request topic name used by queue
queue.integration_api.responses_topic TB_QUEUE_INTEGRATION_EXECUTOR_API_RESPONSE_TOPIC tb_ie.api.responses Default Integration Api response topic name used by queue
queue.integration_api.max_pending_requests TB_QUEUE_INTEGRATION_EXECUTOR_MAX_PENDING_REQUESTS 10000 Maximum pending api requests from integration executor to be handled by server<
queue.integration_api.max_requests_timeout TB_QUEUE_INTEGRATION_EXECUTOR_MAX_REQUEST_TIMEOUT 10000 Maximum timeout in milliseconds to handle api request from integration executor microservice by server
queue.integration_api.max_callback_threads TB_QUEUE_INTEGRATION_EXECUTOR_MAX_CALLBACK_THREADS 10 Amount of threads used to invoke callbacks
queue.integration_api.request_poll_interval TB_QUEUE_INTEGRATION_EXECUTOR_REQUEST_POLL_INTERVAL_MS 25 Interval in milliseconds to poll api requests from integration executor microservices
queue.integration_api.response_poll_interval TB_QUEUE_INTEGRATION_EXECUTOR_RESPONSE_POLL_INTERVAL_MS 25 Interval in milliseconds to poll api response from integration executor microservices

TBEL参数

参数环境变量默认值描述
tbel.enabled TBEL_ENABLED true 启用/禁用TBEL功能。
tbel.max_total_args_size TBEL_MAX_TOTAL_ARGS_SIZE 100000 限制传递给函数以执行脚本的参数数量
tbel.max_result_size TBEL_MAX_RESULT_SIZE 300000 处理脚本后结果中允许的最大符号数
tbel.max_script_body_size TBEL_MAX_SCRIPT_BODY_SIZE 50000 脚本主体中允许的最大符号数
tbel.max_memory_limit_mb TBEL_MAX_MEMORY_LIMIT_MB 8 允许的最大TBEL脚本执行内存
tbel.max_errors TBEL_MAX_ERRORS 3 TBEL脚本被列入黑名单之前允许的最大执行错误数
tbel.max_requests_timeout TBEL_MAX_REQUEST_TIMEOUT 500 TBEL Eval最大请求超时（以毫秒为单位）。0 - 无超时
tbel.max_black_list_duration_sec TBEL_MAX_BLACKLIST_DURATION_SEC 60 黑名单功能在列表中停留的最长时间（以秒为单位）。
tbel.thread_pool_size TBEL_THREAD_POOL_SIZE 50 指定javascript执行器服务的线程池大小
tbel.stats.enabled TB_TBEL_STATS_ENABLED false 启用/禁用TBEL引擎的统计信息收集
tbel.stats.print_interval_ms TB_TBEL_STATS_PRINT_INTERVAL_MS 10000 TBEL统计数据的记录间隔

JS参数

参数环境变量默认值描述
js.evaluator JS_EVALUATOR local 本地（Nashorn引擎，已弃用）或远程JS执行器(NodeJS)
js.local.js_thread_pool_size LOCAL_JS_THREAD_POOL_SIZE 50 指定javascript执行器服务的线程池大小
js.local.use_js_sandbox USE_LOCAL_JS_SANDBOX true 使用沙盒（安全）JVM JavaScript环境
js.local.monitor_thread_pool_size LOCAL_JS_SANDBOX_MONITOR_THREAD_POOL_SIZE 4 指定JavaScript沙箱资源监视器的线程池大小
js.local.max_cpu_time LOCAL_JS_SANDBOX_MAX_CPU_TIME 8000 脚本执行允许的最大CPU时间（以毫秒为单位）
js.local.max_errors LOCAL_JS_SANDBOX_MAX_ERRORS 3 JavaScript将被列入黑名单之前允许的最大JavaScript执行错误数
js.local.max_requests_timeout LOCAL_JS_MAX_REQUEST_TIMEOUT 0 JS Eval最大请求超时. 0 - no timeout
js.local.max_black_list_duration_sec LOCAL_JS_SANDBOX_MAX_BLACKLIST_DURATION_SEC 60 黑名单功能在列表中停留的最长时间（以秒为单位）。
js.local.stats.enabled TB_JS_LOCAL_STATS_ENABLED false 启用/禁用本地JS执行器的统计信息收集
js.local.stats.print_interval_ms TB_JS_LOCAL_STATS_PRINT_INTERVAL_MS 10000 本地JS执行器统计信息的日志记录间隔
js.remote.js_thread_pool_size REMOTE_JS_THREAD_POOL_SIZE 50 指定javascript执行器服务的线程池大小
js.remote.max_errors REMOTE_JS_SANDBOX_MAX_ERRORS 3 JavaScript将被列入黑名单之前允许的最大JavaScript执行错误数
js.remote.max_black_list_duration_sec REMOTE_JS_SANDBOX_MAX_BLACKLIST_DURATION_SEC 60 黑名单功能在列表中停留的最长时间（以秒为单位）。
js.remote.stats.enabled TB_JS_REMOTE_STATS_ENABLED false 启用/禁用远程JS执行器的统计信息收集
js.remote.stats.print_interval_ms TB_JS_REMOTE_STATS_PRINT_INTERVAL_MS 10000 远程JS执行器统计记录的时间间隔

JSON转换器参数

参数环境变量默认值描述
transport.json.type_cast_enabled JSON_TYPE_CAST_ENABLED true 处理遥测/属性JSON时尽可能将String转为Numeric
transport.json.max_string_value_length JSON_MAX_STRING_VALUE_LENGTH 0 处理遥测/属性JSON时允许的最大字符串长度(0表示禁用长度检查)

缓存参数

参数环境变量默认值描述
cache.type CACHE_TYPE redis caffeine或redis
cache.maximumPoolSize CACHE_MAXIMUM_POOL_SIZE 16 处理调用外部缓存的future的最大池大小
cache.specs.devices.timeToLiveInMinutes CACHE_SPECS_DEVICES_TTL 1440 设备缓存TTL
cache.specs.devices.maxSize CACHE_SPECS_DEVICES_MAX_SIZE 10000 0表示缓存被禁用
cache.specs.downlink.timeToLiveInMinutes CACHE_SPECS_DOWNLINK_TTL 1440 Downlink converter cache specs TTL
cache.specs.downlink.maxSize CACHE_SPECS_DOWNLINK_MAX_SIZE 100000 0 means the cache is disabled
cache.specs.integrations.timeToLiveInMinutes CACHE_SPECS_INTEGRATIONS_TTL 1440 integrations cache specs TTL
cache.specs.integrations.maxSize CACHE_SPECS_INTEGRATIONS_MAX_SIZE 10000 0 means the cache is disabled
cache.rateLimits.timeToLiveInMinutes CACHE_SPECS_RATE_LIMITS_TTL 60 速率限制缓存TTL
cache.rateLimits.maxSize CACHE_SPECS_RATE_LIMITS_MAX_SIZE 100000 0表示缓存被禁用

Redis/Valkey配置参数

参数环境变量默认值描述
redis.connection.type REDIS_CONNECTION_TYPE standalone 独立或集群或哨兵
redis.standalone.host REDIS_HOST localhost Redis连接主机
redis.standalone.port REDIS_PORT 6379 Redis连接端口
redis.standalone.useDefaultClientConfig REDIS_USE_DEFAULT_CLIENT_CONFIG true 使用默认的Redis配置文件
redis.standalone.clientName REDIS_CLIENT_NAME standalone 仅当您使用非默认ClientConfig时才可以使用此值
redis.standalone.connectTimeout REDIS_CLIENT_CONNECT_TIMEOUT 30000 仅当您使用非默认ClientConfig时才可以使用此值
redis.standalone.readTimeout REDIS_CLIENT_READ_TIMEOUT 60000 仅当您使用非默认ClientConfig时才可以使用此值
redis.standalone.usePoolConfig REDIS_CLIENT_USE_POOL_CONFIG false 仅当您使用非默认ClientConfig时才可以使用此值
redis.cluster.nodes REDIS_NODES 用于引导的"host:port"对列表（逗号分隔）.
redis.cluster.max-redirects REDIS_MAX_REDIRECTS 12 集群中执行命令时允许的最大重定向数.
redis.cluster.useDefaultPoolConfig REDIS_USE_DEFAULT_POOL_CONFIG true 如果设置为false将使用池配置从池配置部分的值构建
redis.sentinel.master REDIS_MASTER 主节点名称
redis.sentinel.sentinels REDIS_SENTINELS 以逗号分隔的“主机：端口”哨兵对列表
redis.sentinel.password REDIS_SENTINEL_PASSWORD 与哨兵进行身份验证的密码
redis.sentinel.useDefaultPoolConfig REDIS_USE_DEFAULT_POOL_CONFIG true 如果设置为false将使用池配置从池配置部分的值构建
redis.db REDIS_DB 0 数据库索引
redis.password REDIS_PASSWORD 数据库密码
redis.username REDIS_USERNAME 用于ACL身份验证的Redis用户名（Redis 6.0+）。对于旧版仅密码身份验证留空
redis.ssl.enabled TB_REDIS_SSL_ENABLED false 启用/禁用安全连接
redis.ssl.credentials.cert_file TB_REDIS_SSL_PEM_CERT Redis服务器（CA）证书路径
redis.ssl.credentials.user_cert_file TB_REDIS_SSL_PEM_KEY 用户证书文件的路径。这对于客户端来说是可选的，可以用于客户端的双向身份验证
redis.ssl.credentials.user_key_file TB_REDIS_SSL_PEM_KEY_PASSWORD 用户私钥文件的路径。这对于客户端来说是可选的，并且仅在配置了“user_cert_file”时才需要。
redis.pool_config.maxTotal REDIS_POOL_CONFIG_MAX_TOTAL 128 连接池可分配的最大连接数
redis.pool_config.maxIdle REDIS_POOL_CONFIG_MAX_IDLE 128 池中可维持且不被关闭的最大空闲连接数
redis.pool_config.minIdle REDIS_POOL_CONFIG_MIN_IDLE 16 池中可以维持且不被关闭的最小空闲连接数
redis.pool_config.testOnBorrow REDIS_POOL_CONFIG_TEST_ON_BORROW false 借用连接时启用/禁用PING命令发送
redis.pool_config.testOnReturn REDIS_POOL_CONFIG_TEST_ON_RETURN false 该属性用于指定在将连接返回到连接池之前是否对其进行测试。
redis.pool_config.testWhileIdle REDIS_POOL_CONFIG_TEST_WHILE_IDLE true 该属性用于Redis中的连接池上下文
redis.pool_config.minEvictableMs REDIS_POOL_CONFIG_MIN_EVICTABLE_MS 60000 空闲连接在从连接池中被逐出之前应处于空闲状态的最短时间。以毫秒为单位设置的值
redis.pool_config.evictionRunsMs REDIS_POOL_CONFIG_EVICTION_RUNS_MS 30000 指定两次连续驱逐运行之间的时间间隔（以毫秒为单位）
redis.pool_config.maxWaitMills REDIS_POOL_CONFIG_MAX_WAIT_MS 60000 当所有连接都耗尽时，客户端愿意等待池中连接的最长时间（以毫秒为单位）
redis.pool_config.numberTestsPerEvictionRun REDIS_POOL_CONFIG_NUMBER_TESTS_PER_EVICTION_RUN 3 指定每次逐出运行期间要测试逐出的连接数
redis.pool_config.blockWhenExhausted REDIS_POOL_CONFIG_BLOCK_WHEN_EXHAUSTED true 确定当线程从池中请求连接但没有可用连接且池由于maxTotal配置而无法创建更多连接时的行为

CoAP服务端参数

参数环境变量默认值描述
coap.server.enabled COAP_ENABLED true 启用/禁用Coap服务器。
coap.bind_address COAP_BIND_ADDRESS 0.0.0.0 CoAP绑定地址
coap.bind_port COAP_BIND_PORT 5683 CoAP绑定端口
coap.dtls.enabled COAP_DTLS_ENABLED false 启用/禁用DTLS 1.2支持
coap.dtls.retransmission_timeout COAP_DTLS_RETRANSMISSION_TIMEOUT_IN_MILLISECONDS 9000 RFC7925_RETRANSMISSION_TIMEOUT_IN_MILLISECONDS = 9000
coap.dtls.bind_address COAP_DTLS_BIND_ADDRESS 0.0.0.0 CoAP DTLS绑定地址
coap.dtls.bind_port COAP_DTLS_BIND_PORT 5684 CoAP DTLS绑定端口
coap.dtls.connection_id_length COAP_DTLS_CONNECTION_ID_LENGTH CoAP DTLS连接ID长度。RFC 9146，DTLS 1.2的连接标识符 默认值：关闭。
控制DTLS连接ID长度(CID)的使用。
  • 'off'将其停用。
  • “on”激活连接ID支持（与CID 0或更多0相同）。
  • 正值定义生成的CID大小（以字节为单位）。
  • 值0表示我们接受使用CID，但不会为外部对等方生成CID（启用支持，但不支持传入流量）。
  • 0到 <= 4之间的值：使用SingleNodeConnectionIdGenerator
  • 值 > 4：使用MultiNodeConnectionIdGenerator
coap.dtls.max_transmission_unit COAP_DTLS_MAX_TRANSMISSION_UNIT 1024 指定MTU（最大传输单元）。如果未使用LAN MTU，则应使用，例如如果使用IP隧道或者客户端使用小于LAN MTU的值。默认 = 1024最小值 = 64如果设置为0 - 使用LAN MTU。
coap.dtls.max_fragment_length COAP_DTLS_MAX_FRAGMENT_LENGTH 1024 DTLS最大片段长度（RFC 6066，第4节）。默认值 = 1024可能的值：512、1024、2048、4096。如果设置为0，则使用默认最大片段大小2^14字节（16,384字节）。如果没有此扩展，TLS指定固定的最大明文片段长度为2^14字节。由于内存限制或带宽限制，受限客户端可能需要协商较小的最大片段长度。为了协商较小的最大片段长度，客户端可以在（扩展的）客户端问候中包含“max_fragment_length”类型的扩展。该扩展的“extension_data”字段应包含： 
 enum { 2^9(1) == 512, 2^10(2) == 1024, 2^11(3) == 2048, 2^12(4) == 4096, (255) } MaxFragmentLength;
TLS已经要求客户端和服务器支持握手消息的分段。
coap.dtls.credentials.type COAP_DTLS_CREDENTIALS_TYPE PEM 服务器凭证类型(PEM-pem证书文件;KEYSTORE-java keystore)
coap.dtls.credentials.pem.cert_file COAP_DTLS_PEM_CERT coapserver.pem 服务器证书文件路径（含服务器证书或证书链，可包含服务器私钥）
coap.dtls.credentials.pem.key_file COAP_DTLS_PEM_KEY coapserver_key.pem 服务器证书私钥文件的路径。默认可选。如果服务器证书文件中不存在私钥，则为必需；
coap.dtls.credentials.pem.key_password COAP_DTLS_PEM_KEY_PASSWORD server_key_password 服务器证书私钥密码（可选）
coap.dtls.credentials.keystore.type COAP_DTLS_KEY_STORE_TYPE JKS Keystore类型(JKS或PKCS12)
coap.dtls.credentials.keystore.store_file COAP_DTLS_KEY_STORE coapserver.jks 存放SSL证书的keystore路径
coap.dtls.credentials.keystore.store_password COAP_DTLS_KEY_STORE_PASSWORD server_ks_password 访问keystore的密码
coap.dtls.credentials.keystore.key_alias COAP_DTLS_KEY_ALIAS serveralias 密钥别名
coap.dtls.credentials.keystore.key_password COAP_DTLS_KEY_PASSWORD server_key_password 访问密钥的密码
coap.dtls.x509.skip_validity_check_for_client_cert TB_COAP_X509_DTLS_SKIP_VALIDITY_CHECK_FOR_CLIENT_CERT false 跳过客户端证书的有效性检查。
coap.dtls.x509.dtls_session_inactivity_timeout TB_COAP_X509_DTLS_SESSION_INACTIVITY_TIMEOUT 86400000 DTLS会话不活动超时。用于清理缓存
coap.dtls.x509.dtls_session_report_timeout TB_COAP_X509_DTLS_SESSION_REPORT_TIMEOUT 1800000 定期驱逐超时DTLS会话的时间间隔

事件参数

参数环境变量默认值描述
event.debug.rate_limits.enabled DEBUG_MODE_RATE_LIMITS_PER_TENANT_ENABLED true If true rate limits will be active
event.debug.rate_limits.integration INTEGRATION_DEBUG_MODE_RATE_LIMITS_PER_TENANT 50000:3600 No more than 50000 messages per hour
event.debug.rate_limits.converter CONVERTER_DEBUG_MODE_RATE_LIMITS_PER_TENANT 50000:3600 No more than 50000 messages per hour
service.type TB_SERVICE_TYPE tb-integration-executor 服务类型
service.id TB_SERVICE_ID 本服务的唯一ID（空则自动生成）
service.integrations.supported TB_SERVICE_INTEGRATIONS_SUPPORTED ALL Allow to enable integration on service/microservice integration executor. Allowed values: OCEANCONNECT, SIGFOX, THINGPARK, TPE, CHIRPSTACK, TUYA, UDP, TCP, TTN, TTI, AZURE_EVENT_HUB, OPC_UA, IBM_WATSON_IOT, AWS_IOT, AWS_SQS, LORIOT, COAP, AZURE_SERVICE_BUS, HTTP, MQTT or ALL to allow all
service.integrations.excluded TB_SERVICE_INTEGRATIONS_EXCLUDED NONE List of integrations to exclude from processing on service/microservice integration executor. Allowed values: OCEANCONNECT, SIGFOX, THINGPARK, TPE, CHIRPSTACK, TUYA, UDP, TCP, TTN, TTI, AZURE_EVENT_HUB, OPC_UA, IBM_WATSON_IOT, AWS_IOT, AWS_SQS, LORIOT, COAP, AZURE_SERVICE_BUS, HTTP, MQTT. By default NONE

使用统计参数

参数环境变量默认值描述
usage.stats.report.enabled USAGE_STATS_REPORT_ENABLED true 启用/禁用API使用统计收集。默认在系统和租户级别收集
usage.stats.report.enabled_per_customer USAGE_STATS_REPORT_PER_CUSTOMER_ENABLED false 启用/禁用客户级API使用统计收集
usage.stats.report.interval USAGE_STATS_REPORT_INTERVAL 60 统计上报间隔。默认每10秒发送汇总统计
usage.stats.report.pack_size USAGE_STATS_REPORT_PACK_SIZE 1024 每个包中的统计消息数

指标参数

参数环境变量默认值描述
metrics.enabled METRICS_ENABLED false 启用/禁用actuator指标。
metrics.timer.percentiles METRICS_TIMER_PERCENTILES 0.5 计时器指标的执行器返回的指标百分位数。双精度值列表（除以,）。

通用管理参数

参数环境变量默认值描述
management.endpoints.web.exposure.include METRICS_ENDPOINTS_EXPOSE info 暴露指标端点（使用'prometheus'启用prometheus指标）。

通知系统参数

参数环境变量默认值描述
notification_system.rules.deduplication_durations TB_NOTIFICATION_RULES_DEDUPLICATION_DURATIONS RATE_LIMITS:14400000; 触发器类型的去重时长（毫秒，分号分隔）。格式：'NotificationRuleTriggerType1:123;NotificationRuleTriggerType2:456'
mqtt.client.retransmission.max_attempts TB_MQTT_CLIENT_RETRANSMISSION_MAX_ATTEMPTS 3 允许的最大重传尝试次数。如果尝试计数超过此值，重传将停止，待处理的消息将被丢弃。
mqtt.client.retransmission.initial_delay_millis TB_MQTT_CLIENT_RETRANSMISSION_INITIAL_DELAY_MILLIS 5000 第一次重传尝试之前的基本延迟（以毫秒为单位），从发送消息的那一刻开始测量。随后的延迟是使用指数退避计算的。该基本延迟也用作应用抖动的参考值。
mqtt.client.retransmission.jitter_factor TB_MQTT_CLIENT_RETRANSMISSION_JITTER_FACTOR 0.15 应用于计算的重传延迟的抖动因子。实际延迟在通过将基本延迟乘以(1 - jitter_factor)和(1 + jitter_factor)之间的因子定义的范围内随机化。例如，jitter_factor为0.15意味着实际延迟可能会变化达基本延迟的 ±15%。