您可以经过Ansible在多个 Linux 主机上扩展OpenTelemetry 搜集器的布置,使其在您的可观测性架构中既作为网关又作为署理。在此双重身份中运用 OpenTelemetry 搜集器能够将方针、盯梢和日志可靠地搜集并转发到分析和可视化平台。
译自Manage OpenTelemetry Collectors at scale with Ansible,作者 OpenTelemetry Authors; Docs CC BY。
咱们概述了一种运用 Ansible 在整个根底架构中布置和办理 OpenTelemetry 搜集器可扩展实例的战略。在以下示例中,咱们将运用Grafana作为方针的方针后端。
先决条件
在开端之前,请确保您满意以下要求:
- 在您的基本系统上装置了 Ansible
- SSH 拜访两个或更多 Linux 主机
- 装备了 Prometheus 以搜集您的方针
装置 Grafana Ansible 调集
OpenTelemetry 搜集器人物经过Grafana Ansible 调集供给,版本为 4.0。
要装置 Grafana Ansible 调集,请运转此指令:
ansible-galaxy collection install grafana.grafana
创立 Ansible 清单文件
接下来,搜集与您的 Linux 主机相关的 IP 地址和 URL,并创立一个清单文件。
- 创立 Ansible 清单文件。
Ansible 清单(坐落名为 inventory 的文件中)将每个主机 IP 列在单独的行上,如下所示(显现 8 个主机):
10.0.0.1 # hostname = ubuntu-01
10.0.0.2 # hostname = ubuntu-02
10.0.0.3 # hostname = centos-01
10.0.0.4 # hostname = centos-02
10.0.0.5 # hostname = debian-01
10.0.0.6 # hostname = debian-02
10.0.0.7 # hostname = fedora-01
10.0.0.8 # hostname = fedora-02
- 在与 inventory 相同的目录中创立一个 ansible.cfg 文件,并运用以下值:
[defaults]
inventory = inventory # 清单文件的路径
private_key_file = ~/.ssh/id_rsa # 私有 SSH 密钥的路径
remote_user=root
运用 OpenTelemetry Collector Ansible 人物
接下来,定义一个 Ansible playbook 来在您的主机上使用您挑选或创立的 OpenTelemetry Collector 人物。
在与 ansible.cfg 和 inventory 文件相同的目录中创立一个名为 deploy-opentelemetry.yml 的文件:
- name: Install OpenTelemetry Collector
hosts: all
become: true
tasks:
- name: Install OpenTelemetry Collector
ansible.builtin.include_role:
name: opentelemetry_collectorr
vars:
otel_collector_receivers:
hostmetrics:
collection_interval: 60s
scrapers:
cpu: {}
disk: {}
load: {}
filesystem: {}
memory: {}
network: {}
paging: {}
process:
mute_process_name_error: true
mute_process_exe_error: true
mute_process_io_error: true
processes: {}
otel_collector_processors:
batch:
resourcedetection:
detectors: [env, system]
timeout: 2s
system:
hostname_sources: [os]
transform/add_resource_attributes_as_metric_attributes:
error_mode: ignore
metric_statements:
- context: datapoint
statements:
- set(attributes["deployment.environment"],
resource.attributes["deployment.environment"])
- set(attributes["service.version"],
resource.attributes["service.version"])
otel_collector_exporters:
prometheusremotewrite:
endpoint: https://<prometheus-url>/api/prom/push
headers:
Authorization: 'Basic <base64-encoded-username:password>'
otel_collector_service:
pipelines:
metrics:
receivers: [hostmetrics]
processors:
[
resourcedetection,
transform/add_resource_attributes_as_metric_attributes,
batch,
]
exporters: [prometheusremotewrite]
留意:调整装备以匹配您打算搜集的特定遥测以及您计划将其转发到的位置。此装备片段是一个基本示例,旨在搜集转发到 Prometheus 的主机方针。
之前的装备将装备 OpenTelemetry Collector 以从 Linux 主机搜集方针。
运转 Ansible Playbook
经过运转以下指令在您的主机上布置 OpenTelemetry Collector:
ansible-playbook deploy-opentelemetry.yml
在后端检查您的方针
在您的 OpenTelemetry 搜集器开端向 Prometheus 发送方针后,请按照以下步骤在 Grafana 中对其进行可视化:
设置 Grafana
-
装置 Docker:确保您的系统上装置了 Docker。
-
运转 Grafana Docker 容器:运用以下指令启动 Grafana 服务器,该指令将获取最新的 Grafana 映像:
docker run -d -p 3000:3000 --name=grafana grafana/grafana
-
拜访 Grafana:在您的网络浏览器中打开http://localhost:3000。默认登录用户名和暗码都是 admin。
-
更改暗码:在首次登录时提示时 – 挑选一个安全的暗码!
有关其他装置方法和更具体的阐明,请参阅Grafana 文档。
添加 Prometheus 作为数据源
- 在 Grafana 中,导航至Connections>Data Sources。
- 单击Add data source并挑选Prometheus。
- 在设置中,输入您的 Prometheus URL,例如,
http://<your_prometheus_host>
,以及任何其他必需的具体信息。 - 挑选Save & Test。
探究您的方针
-
转到Explore页面。
-
在查询编辑器中,挑选您的数据源并输入以下查询:
100 - (avg by (cpu) (irate(system_cpu_time{state="idle"}[5m])) * 100)
此查询核算过去 5 分钟内每个 CPU 中心未处于“闲暇”状态的 CPU 时刻的平均百分比。
- 探究其他方针并创立仪表盘以深入了解您系统的功能。
这篇博文阐明了怎么凭借 Ansible 装备和布置多个 OpenTelemetry 搜集器跨各种 Linux 主机,以及在 Grafana 中可视化搜集到的遥测数据。假如您觉得这有用,GitHub 存储库用于OpenTelemetry Collector 人物以获取具体的装备选项。假如您有任何问题,您可以运用我的 GitHub 个人资料中的联系方式与我联系@ishanjainn。
本文在如此众生(yylives.cc/)首发,欢迎大家拜访。