Sentilo平台集成方案详解：7大Agent模块功能与配置指南

Sentilo平台集成方案详解：7大Agent模块功能与配置指南

sentilo Sentilo platform 项目地址: https://gitcode.com/gh_mirrors/se/sentilo

什么是Sentilo Agent模块

Sentilo平台通过Agent模块实现功能扩展，这些模块采用插件化设计，遵循即插即用原则。Agent本质上是一个独立进程，通过订阅Redis的发布/订阅通道获取数据输入，然后执行特定的业务逻辑处理。这种架构设计使得系统功能扩展无需修改核心代码，保持了系统的高内聚低耦合特性。

Agent核心架构设计

所有Agent模块都遵循统一的设计模式：

1. 订阅阶段：Agent启动时作为独立客户端订阅Redis的特定事件通道
2. 消息接收：当Redis收到相关数据发布时，自动通知订阅的Agent
3. 业务处理：Agent将接收到的消息转交给内部服务处理，执行对应的业务逻辑

这种设计模式确保了数据处理的高效性和系统的可扩展性。

Sentilo提供的7大Agent模块

1. 关系型数据库Agent

功能概述： 将平台接收的所有数据存储到关系型数据库(如MySQL、PostgreSQL等)，支持通过配置文件设置业务规则过滤需要存储的数据。

关键配置参数：

• subscriptions：使用正则表达式定义订阅事件模式
  • 示例：/data/PROVIDER1/*,/data/PROVIDER2/* 表示仅存储两个指定提供商的数据

数据源配置： 通过Spring的persistence context文件定义数据源连接，支持配置连接池参数：

• 初始连接数(initialSize)
• 最小空闲连接(minIdle)
• 最大活跃连接(maxActive)
• 验证查询(validationQuery)等

数据库初始化： 提供多种数据库的初始化SQL脚本，支持主流关系型数据库的快速部署。

2. 告警Agent

双线程处理机制：

• 定时检查线程：每分钟运行一次，评估所有配置了"冻结"类型告警的传感器状态
• 实时处理线程：接收Redis通知时立即处理相关告警
• 同步线程：定期同步告警列表，保持内存与目录仓库数据一致

告警类型支持： 主要处理数据完整性规则的验证，当规则不满足时发布告警通知。

3. 活动监控Agent

ELK技术栈集成：

• 背景：解决Redis内存限制导致的数据过期问题，提供可定制的仪表板
• 架构：使用Elasticsearch存储历史数据，Kibana提供可视化
• 数据流：Agent将Sentilo事件上传到Elasticsearch，自动创建按月份分区的索引(sentilo-YYYY-MM)

关键配置：

• elasticsearch.url：Elasticsearch实例地址
• subscriptions：定义需要监控的事件类型

版本兼容性： 已验证支持ELK 5+版本，建议使用较新的稳定版本。

4. 历史数据Agent

OpenTSDB集成方案：

• 背景：针对大规模时间序列数据的持久化存储
• 架构：基于HBase和HDFS构建，通过Grafana可视化
• 特点：支持海量时间序列数据的高效存储和查询

特色配置参数：

• metrics.fromSensorType：切换指标命名方式(使用传感器类型或提供商+传感器名称)
• metrics.usePublishedAtTimestamp：选择使用事件发布时间还是消息时间作为时间戳

版本验证：

• Hadoop 2.7.2
• HBase 1.2.1
• OpenTSDB 2.2.0/2.3.0
• Grafana 3+

5. 联邦Agent

跨实例数据共享：

• 架构：实现两个独立Sentilo实例间的单向事件共享
• 工作流程：
  1. 发送方实例创建新应用并生成token
  2. 接收方实例自动同步目录信息
  3. 建立HTTP端点接收转发事件

自动目录同步： Agent自动查询远程目录API并在本地实例中创建对应的提供者、组件和传感器。

关键配置：

• server.port：Agent HTTP服务端口(默认8082)
• sentilo.agent.federation.api_server.local.endpoint：本地API服务器地址

6. Kafka Agent

（注：原文未提供详细内容，此处补充说明） 功能：将Sentilo事件转发到Kafka消息队列，实现与大数据处理系统的集成。

7. 指标监控Agent

（注：原文未提供详细内容，此处补充说明） 功能：收集平台运行指标，用于性能监控和系统健康状态评估。

配置继承机制

所有Agent都继承自基础配置(sentilo.agent)，这些基础配置定义在主配置文件中，各个Agent可以通过自己的配置文件(agent-xxx.conf)覆盖这些默认设置。这种设计提供了配置的灵活性和统一管理能力。

最佳实践建议

1. 性能调优：根据数据量调整关系型数据库Agent的连接池参数
2. 监控策略：结合活动监控Agent和历史数据Agent构建完整的监控体系
3. 数据过滤：合理使用subscriptions配置减少不必要的数据处理
4. 版本兼容性：部署时注意各组件版本匹配，避免兼容性问题

通过这七大Agent模块，Sentilo平台可以灵活适应各种物联网场景的需求，实现数据的多样化处理和持久化存储。

sentilo Sentilo platform 项目地址: https://gitcode.com/gh_mirrors/se/sentilo