diagrams 绘制 Elastic 云架构图elastic provider 全部节点类完整参考与实战指南【免费下载链接】diagrams:art: Diagram as Code for prototyping cloud system architectures项目地址: https://gitcode.com/GitHub_Trending/di/diagrams在 diagramsDiagram as Code项目中elastic是与 AWS、GCP、K8s 等并列的内置 provider用于把 Elastic 技术栈中的 Agent、Beats、Elasticsearch、Enterprise Search、可观测性与安全组件绘制为架构图节点。本文以官方节点参考文档 docs/nodes/elastic.md 为主体逐模块列出其全部节点类、命名空间与导入路径并结合 diagrams/elastic 目录下的源码解释节点机制与别名用法最后给出可直接运行的开源版 Elastic 观测架构图代码示例帮助读者把真实部署映射成图。一、Elastic provider 概览文档到底讲了什么Elastic 官方为产品线提供了大量官方图标与节点diagrams 仓库通过resources/elastic图标目录与自动生成的 Python 模块把它们组织为diagrams.elastic.module.Node三层命名空间。该文档正是这套命名空间下全部节点类的权威清单共 8 个模块agent、beats、elasticsearch、enterprisesearch、observability、orchestration、saas、security每个类代表一个真实 Elastic 产品或组件。从源码看Elastic provider 的公共基类定义在 diagrams/elastic/__init__.pyfrom diagrams import Node class _Elastic(Node): _provider elastic _icon_dir resources/elastic fontcolor #ffffff基类将_provider固定为elasticfontcolor统一为白色因此所有 Elastic 节点默认使用同一套配色每个模块文件由 autogen.sh 自动生成、文件头标注DO NOT EDIT再继承该基类通过_type与_icon指向具体图标。二、按模块全面解析 Elastic 节点类使用方式统一为from diagrams.provider.type import Node后在with Diagram(...)上下文内实例化。下面按文档顺序逐模块给出全部节点与真实语义说明。2.1 elastic.agentElastic Agent 管理面对应模块源码diagrams/elastic/agent.py。节点类导入路径对应产品/语义Agentdiagrams.elastic.agent.AgentElastic Agent统一的数据采集代理可安装在主机/容器Endpointdiagrams.elastic.agent.Endpoint端点安全 Agent与 security.Endpoint 不同此处为 Agent 范畴的端点防护Fleetdiagrams.elastic.agent.FleetFleet Server集中管理、下发 Agent 策略的控制面Integrationsdiagrams.elastic.agent.Integrations集成包将 Beats/Agent 采集能力打包为可安装的 integration典型用法示意from diagrams import Diagram from diagrams.elastic.agent import Fleet, Agent, Integrations with Diagram(Agent 管理体系, showFalse): Fleet(fleet) Agent(host agent) Integrations(nginx)在架构图中Fleet通常作为中心管理节点向下连接部署在集群里的多个AgentEndpoint与Integrations用于表达安全策略与采集集成能力。2.2 elastic.beats轻量级数据采集器Beats对应模块源码diagrams/elastic/beats.py。该模块收录了 Elastic 主流的 8 个轻量级 shipper它们负责把各类数据投递到 Elasticsearch 或 Logstash节点类导入路径对应产品/语义APMdiagrams.elastic.beats.APMAPM Agent/Server应用性能监控数据入口Auditbeatdiagrams.elastic.beats.Auditbeat审计数据采集文件完整性、登录与进程审计Filebeatdiagrams.elastic.beats.Filebeat日志文件采集最常用的日志 shipperFunctionbeatdiagrams.elastic.beats.Functionbeat面向云函数的采集器部署为 serverless 函数Heartbeatdiagrams.elastic.beats.Heartbeat主动探活对服务可用性与延迟进行探测Metricbeatdiagrams.elastic.beats.Metricbeat指标采集系统/中间件/服务的 metricPacketbeatdiagrams.elastic.beats.Packetbeat网络数据包分析应用协议流量嗅探Winlogbeatdiagrams.elastic.beats.WinlogbeatWindows 事件日志采集该模块覆盖“日志 指标 探活 审计 流量 APM”六类采集需求是绘制日志/指标管线的核心素材。2.3 elastic.elasticsearchELK 核心组件与平台能力对应模块源码diagrams/elastic/elasticsearch.py。这是整个 elastic provider 中类数量最多的模块涵盖 Elasticsearch、Kibana、Logstash 三大核心以及围绕它们的平台级能力节点类导入路径对应产品/语义Alertingdiagrams.elastic.elasticsearch.Alerting告警与通知规则引擎Beatsdiagrams.elastic.elasticsearch.Beats汇总层入口接收各类 Beats 数据Elasticsearchdiagrams.elastic.elasticsearch.Elasticsearch分布式搜索与分析引擎存储/索引核心Kibanadiagrams.elastic.elasticsearch.Kibana可视化与操作台前端LogstashPipelinediagrams.elastic.elasticsearch.LogstashPipelineLogstash 数据处理管道pipeline 语义Logstashdiagrams.elastic.elasticsearch.LogstashLogstash服务端数据处理管道MachineLearningdiagrams.elastic.elasticsearch.MachineLearning机器学习异常检测等 ML 能力MapServicesdiagrams.elastic.elasticsearch.MapServices地图服务Mapsdiagrams.elastic.elasticsearch.MapsKibana Maps地理数据可视化Monitoringdiagrams.elastic.elasticsearch.Monitoring集群自身的监控Stack MonitoringSearchableSnapshotsdiagrams.elastic.elasticsearch.SearchableSnapshots可搜索快照低成本冷数据分层SecuritySettingsdiagrams.elastic.elasticsearch.SecuritySettings集群安全设置认证/授权/加密SQLdiagrams.elastic.elasticsearch.SQLElasticsearch SQL 查询能力Stackdiagrams.elastic.elasticsearch.Stack整个 Elastic Stack 的聚合节点该模块是唯一的别名来源源码 diagrams/elastic/elasticsearch.py 中定义ElasticSearch Elasticsearch LogStash Logstash ML MachineLearning因此diagrams.elastic.elasticsearch.ElasticSearch、LogStash、ML三种旧式/缩写写法同样可用——这一点与文档中标注的ElasticSearch (alias)、LogStash (alias)、ML (alias)完全对应能兼容不同习惯的历史代码。2.4 elastic.enterprisesearch企业搜索产品线对应模块源码diagrams/elastic/enterprisesearch.py。用于绘制企业内部搜索解决方案节点类导入路径对应产品/语义AppSearchdiagrams.elastic.enterprisesearch.AppSearchApp Search开箱即用的搜索体验 APICrawlerdiagrams.elastic.enterprisesearch.Crawler网络爬虫抓取站点内容喂给搜索索引EnterpriseSearchdiagrams.elastic.enterprisesearch.EnterpriseSearchEnterprise Search 平台本体SiteSearchdiagrams.elastic.enterprisesearch.SiteSearchSite Search面向网站的搜索服务WorkplaceSearchdiagrams.elastic.enterprisesearch.WorkplaceSearchWorkplace Search统一检索内部系统文档、协作工具等2.5 elastic.observability可观测性解决方案对应模块源码diagrams/elastic/observability.py。与前文beats.APM采集端不同此处是 Kibana 内的可观测性应用模块节点类导入路径对应产品/语义APMdiagrams.elastic.observability.APMObservability 中的 APM 应用视图Logsdiagrams.elastic.observability.Logs日志流分析应用Metricsdiagrams.elastic.observability.Metrics基础设施指标监控应用Observabilitydiagrams.elastic.observability.Observability可观测性总体入口Uptimediagrams.elastic.observability.Uptime服务可用性/Uptime 监控绘制完整监控体系时可同时出现beats.APM数据源与observability.APM分析端两者在图中职责不同需要按数据流方向区分。2.6 elastic.orchestration编排与交付形态对应模块源码diagrams/elastic/orchestration.py。仅两个类用于表达 Elastic 的两种托管/编排交付节点类导入路径对应产品/语义ECEdiagrams.elastic.orchestration.ECEElastic Cloud Enterprise私有化多租户编排平台ECKdiagrams.elastic.orchestration.ECKElastic Cloud on KubernetesK8s 原生 operator 编排绘制 K8s 部署架构时ECK常与 diagrams.k8s 的 Pod/Deployment 节点组合使用。2.7 elastic.saasElastic 云托管服务对应模块源码diagrams/elastic/saas.py节点类导入路径对应产品/语义Clouddiagrams.elastic.saas.CloudElastic Cloud官方托管云服务Elasticdiagrams.elastic.saas.ElasticElastic 品牌级整体节点2.8 elastic.security安全分析解决方案对应模块源码diagrams/elastic/security.py。绘制 SIEM/XDR 安全运营架构时使用节点类导入路径对应产品/语义Endpointdiagrams.elastic.security.EndpointSecurity 场景的端点安全防护Securitydiagrams.elastic.security.SecurityElastic Security 应用本体SIEMdiagrams.elastic.security.SIEMSIEM安全信息与事件管理Xdrdiagrams.elastic.security.XdrXDR跨层扩展检测与响应三、实战示例绘制一套完整 Elastic 观测/安全架构图diagrams 的Node本质只是“带 provider/type/name 的组件对象”机制详见 docs/guides/node.md节点之间用、、-连接成边。将上面的节点组合起来即可把真实部署一键转成图。以一套“日志 指标 APM 全链路、带监控与安全组件”的部署为例from diagrams import Cluster, Diagram from diagrams.elastic.agent import Agent, Fleet from diagrams.elastic.beats import Auditbeat, Filebeat, Heartbeat, Metricbeat from diagrams.elastic.elasticsearch import ( Elasticsearch, Kibana, Logstash, MachineLearning, Monitoring, SecuritySettings, ) from diagrams.elastic.observability import APM, Logs, Metrics, Uptime from diagrams.elastic.orchestration import ECK from diagrams.elastic.security import SIEM, Endpoint, Security from diagrams.k8s.compute import Pod with Diagram(Elastic 观测与安全架构, showFalse, directionTB): fleet Fleet(策略下发) with Cluster(Kubernetes 集群 (ECK 编排)): es Elasticsearch(es-master) with Cluster(数据采集 Pod): agents [Agent(采集 Agent) for _ in range(3)] filebeat Filebeat(应用日志) metricbeat Metricbeat(系统指标) auditbeat Auditbeat(审计数据) heartbeat Heartbeat(主动探活) with Cluster(服务端处理): logstash Logstash(pipeline 清洗) ml MachineLearning(异常检测) # 数据流向采集 - 汇聚 - 存储 filebeat logstash metricbeat logstash logstash es # ES 平台能力与安全/监控 es SecuritySettings(安全加固) [SIEM(SIEM), Security(安全分析)] es - Monitoring(Stack 监控) - Kibana(可视化) # 管理面与编排关系 fleet agents agents filebeat agents auditbeat agents heartbeat ECK(ECK operator) es # 可观测性前端应用 Kibana(可视化) [APM(APM), Logs(日志), Metrics(指标), Uptime(探活)]该示例同时演示了集群分组Cluster、列表批量连线、directionTB改变默认方向、以及 Elastic 节点与 k8s 节点混排——这都是 docs/guides/node.md 中记载的通用能力。在 CLI 中执行python demo.py同目录即会生成 PNG/SVG 图若showFalse则不自动弹出。四、源码视角节点是如何生成的从代码结构可观察到以下实现事实便于理解此文档的生成逻辑统一公共基类所有 Elastic 节点共享 diagrams/elastic/__init__.py 中的_Elastic设定_providerelastic、白色字体保证整套图标视觉一致。模块文件自动生成每个模块文件头部均标注This module is automatically generated by autogen.sh. DO NOT EDIT.即节点类由仓库脚本 autogen.sh 依据资源清单自动产出因此文档中的类清单与源码一一对应、不会出现手写偏差。双层类继承定位图标例如agent.py中先定义模块私有基类_Agent(_Elastic)指定_typeagent、_icon_dirresources/elastic/agent再由具体类如Agent(_Agent)指定_icon agent.png。_type_icon组合最终决定节点使用的图标资源。别名以模块级赋值实现别名如ElasticSearch、LogStash、ML不是新类而是模块末尾的直接赋值见 diagrams/elastic/elasticsearch.py。因此当需要确认某个节点到底支持哪些类、或新增节点后想核对清单时直接对照 docs/nodes/elastic.md 与对应模块源码即可二者由同一份资源数据驱动天然保持一致。五、总结如何按需选用 Elastic 节点面对一张待绘制的 Elastic 架构图可按以下思路在本文档中“查表选型”画数据采集看elastic.agentAgent/Fleet/Integrations与elastic.beatsFilebeat/Metricbeat/Auditbeat/Heartbeat/Packetbeat/Functionbeat/Winlogbeat/APM画核心集群看elastic.elasticsearchElasticsearch/Logstash/Kibana 三件套以及 SQL、ML、Maps、Monitoring、SearchableSnapshots、SecuritySettings、Alerting 等能力节点别名兼容历史写法画企业搜索看elastic.enterprisesearchEnterpriseSearch/AppSearch/SiteSearch/WorkplaceSearch/Crawler画可观测性方案看elastic.observabilityLogs/Metrics/APM/Uptime画部署形态看elastic.orchestrationECE/ECK与elastic.saasCloud/Elastic画安全运营看elastic.securitySIEM/XDR/Endpoint/Security。各模块源码文件路径如下方便直接核对实现agent.py、beats.py、elasticsearch.py、enterprisesearch.py、observability.py、orchestration.py、saas.py、security.py。配合 diagrams 的整体节点机制文档 docs/guides/node.md即可把真实 Elastic 部署以「代码即图」的方式快速沉淀为架构文档。【免费下载链接】diagrams:art: Diagram as Code for prototyping cloud system architectures项目地址: https://gitcode.com/GitHub_Trending/di/diagrams创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考