Metricbeat 快速入门:安装和配置
编辑Metricbeat 快速入门:安装和配置
编辑Metricbeat 通过收集操作系统和服务的指标来帮助您监控服务器及其托管的服务。
本指南介绍了如何快速开始收集指标。您将学习如何
- 在您要监控的每个系统上安装 Metricbeat
- 指定您要收集的指标
- 将指标发送到 Elasticsearch
- 在 Kibana 中可视化指标数据
开始之前
编辑您需要 Elasticsearch 来存储和搜索数据,以及 Kibana 来可视化和管理数据。
为了快速入门,请启动我们的 托管 Elasticsearch Service 部署。Elasticsearch Service 在 AWS、GCP 和 Azure 上可用。免费试用。
要安装和运行 Elasticsearch 和 Kibana,请参阅 安装 Elastic Stack。
步骤 1:安装 Metricbeat
编辑将 Metricbeat 安装在尽可能靠近您要监控的服务的地方。例如,如果您有四台运行 MySQL 的服务器,建议您在每台服务器上运行 Metricbeat。这使 Metricbeat 可以从本地主机访问您的服务,并且不会导致额外的网络流量,也不会在出现网络问题时阻止 Metricbeat 收集指标。来自多个 Metricbeat 实例的指标将在 Elasticsearch 服务器上合并。
要下载和安装 Metricbeat,请使用适用于您的系统的命令
curl -L -O https://artifacts.elastic.co/downloads/beats/metricbeat/metricbeat-8.17.0-amd64.deb sudo dpkg -i metricbeat-8.17.0-amd64.deb
curl -L -O https://artifacts.elastic.co/downloads/beats/metricbeat/metricbeat-8.17.0-x86_64.rpm sudo rpm -vi metricbeat-8.17.0-x86_64.rpm
curl -L -O https://artifacts.elastic.co/downloads/beats/metricbeat/metricbeat-8.17.0-darwin-x86_64.tar.gz tar xzvf metricbeat-8.17.0-darwin-x86_64.tar.gz
curl -L -O https://artifacts.elastic.co/downloads/beats/metricbeat/metricbeat-8.17.0-linux-x86_64.tar.gz tar xzvf metricbeat-8.17.0-linux-x86_64.tar.gz
- 下载 Metricbeat Windows zip 文件:https://artifacts.elastic.co/downloads/beats/metricbeat/metricbeat-8.17.0-windows-x86_64.zip
- 将 zip 文件的内容解压缩到
C:\Program Files
。 - 将
metricbeat-8.17.0-windows-x86_64
目录重命名为Metricbeat
。 - 以管理员身份打开 PowerShell 提示符(右键单击 PowerShell 图标并选择 以管理员身份运行)。
-
从 PowerShell 提示符下,运行以下命令以将 Metricbeat 作为 Windows 服务安装
PS > cd 'C:\Program Files\Metricbeat' PS C:\Program Files\Metricbeat> .\install-service-metricbeat.ps1
如果您的系统上禁用了脚本执行,则需要为当前会话设置执行策略以允许脚本运行。例如:PowerShell.exe -ExecutionPolicy UnRestricted -File .\install-service-metricbeat.ps1
。
显示的命令适用于 AMD 平台,但也有 ARM 包可用。有关可用软件包的完整列表,请参阅下载页面。
其他安装选项
编辑步骤 2:连接到 Elastic Stack
编辑需要连接到 Elasticsearch 和 Kibana 才能设置 Metricbeat。
在 metricbeat.yml
中设置连接信息。要查找此配置文件,请参阅 目录布局。
指定您的 Elasticsearch Service 的 cloud.id,并将 cloud.auth 设置为有权设置 Metricbeat 的用户。例如
cloud.id: "staging:dXMtZWFzdC0xLmF3cy5mb3VuZC5pbyRjZWM2ZjI2MWE3NGJmMjRjZTMzYmI4ODExYjg0Mjk0ZiRjNmMyY2E2ZDA0MjI0OWFmMGNjN2Q3YTllOTYyNTc0Mw==" cloud.auth: "metricbeat_setup:YOUR_PASSWORD"
此示例显示了硬编码的密码,但您应该将敏感值存储在 密钥存储 中。 |
-
设置 Metricbeat 可以找到 Elasticsearch 安装的主机和端口,并设置有权设置 Metricbeat 的用户的用户名和密码。例如
output.elasticsearch: hosts: ["https://myEShost:9200"] username: "metricbeat_internal" password: "YOUR_PASSWORD" ssl: enabled: true ca_trusted_fingerprint: "b9a10bbe64ee9826abeda6546fc988c8bf798b41957c33d05db736716513dc9c"
此示例显示了硬编码的密码,但您应该将敏感值存储在 密钥存储 中。
此示例显示了硬编码的指纹,但您应该将敏感值存储在 密钥存储 中。指纹是 CA 证书的十六进制编码 SHA-256,当您第一次启动 Elasticsearch 时,默认启用诸如 Elasticsearch 的网络加密 (TLS) 之类的安全功能。如果您使用的是 Elasticsearch 首次启动时生成的自签名证书,则需要在此处添加其指纹。指纹打印在 Elasticsearch 启动日志中,或者您可以参考 将客户端连接到 Elasticsearch 文档,以了解有关检索它的其他选项。如果您向 Elasticsearch 提供自己的 SSL 证书,请参阅 有关如何设置 SSL 的 Metricbeat 文档。
-
如果您计划使用我们预构建的 Kibana 仪表板,请配置 Kibana 端点。如果 Kibana 与 Elasticsearch 在同一主机上运行,请跳过此步骤。
运行 Kibana 的机器的主机名和端口,例如,
mykibanahost:5601
。如果在端口号后指定路径,请包括方案和端口:http://mykibanahost:5601/path
。Kibana 的
username
和password
设置是可选的。如果您没有为 Kibana 指定凭据,则 Metricbeat 会使用为 Elasticsearch 输出指定的username
和password
。要使用预构建的 Kibana 仪表板,此用户必须有权查看仪表板或具有
kibana_admin
内置角色。
要了解有关所需角色和权限的更多信息,请参阅 授予用户访问安全资源的权限。
您可以将数据发送到其他 输出,例如 Logstash,但这需要额外的配置和设置。
步骤 3:启用和配置指标收集模块
编辑Metricbeat 使用模块来收集指标。每个模块定义了从特定服务(如 Redis 或 MySQL)收集数据的基本逻辑。一个模块由获取和构建数据的指标集组成。阅读 Metricbeat 的工作原理以了解更多信息。
-
确定您需要启用的模块。要查看可用模块的列表,请运行
metricbeat modules list
metricbeat modules list
./metricbeat modules list
./metricbeat modules list
PS > .\metricbeat.exe modules list
-
从安装目录中,启用一个或多个模块。如果您接受默认配置而不启用其他模块,则 Metricbeat 仅收集系统指标。
以下命令启用
modules.d
目录中的nginx
配置metricbeat modules enable nginx
metricbeat modules enable nginx
./metricbeat modules enable nginx
./metricbeat modules enable nginx
PS > .\metricbeat.exe modules enable nginx
请参阅
modules
命令以了解有关此命令的更多信息。如果您使用的是 Docker 映像,请参阅 在 Docker 上运行 Metricbeat。 - 在
modules.d
下的模块配置中,更改模块设置以匹配您的环境。有关可用设置的更多信息,请参阅 标准配置选项。
要测试您的配置文件,请切换到安装 Metricbeat 二进制文件的目录,并在前台运行 Metricbeat,并指定以下选项:./metricbeat test config -e
。确保您的配置文件位于 Metricbeat 期望的路径中(请参阅 目录布局),或使用 -c
标志来指定配置文件的路径。
有关配置 Metricbeat 的更多信息,另请参阅
- 配置 Metricbeat
- 配置文件格式
-
metricbeat.reference.yml
:此参考配置文件显示所有非弃用的选项。您可以在与metricbeat.yml
相同的位置找到它。
步骤 4:设置资产
编辑Metricbeat 带有预定义的资产,用于解析、索引和可视化您的数据。要加载这些资产
- 确保在
metricbeat.yml
中指定的用户有权设置 Metricbeat。 -
从安装目录中,运行
metricbeat setup -e
metricbeat setup -e
./metricbeat setup -e
./metricbeat setup -e
PS > .\metricbeat.exe setup -e
-e
是可选的,它将输出发送到标准错误而不是配置的日志输出。
此步骤加载推荐的 索引模板 以写入 Elasticsearch,并部署示例仪表板以在 Kibana 中可视化数据。
需要连接到 Elasticsearch(或 Elasticsearch Service)才能设置初始环境。如果您使用其他输出,例如 Logstash,请参阅 手动加载索引模板 和 加载 Kibana 仪表板。
步骤 5:启动 Metricbeat
编辑在启动 Metricbeat 之前,请修改 metricbeat.yml
中的用户凭据,并指定有权发布事件的用户。
要启动 Metricbeat,请运行
sudo service metricbeat start
如果您使用 init.d
脚本启动 Metricbeat,则无法指定命令行标志(请参阅 命令参考)。要指定标志,请在前台启动 Metricbeat。
另请参阅 Metricbeat 和 systemd。
sudo service metricbeat start
如果您使用 init.d
脚本启动 Metricbeat,则无法指定命令行标志(请参阅 命令参考)。要指定标志,请在前台启动 Metricbeat。
另请参阅 Metricbeat 和 systemd。
您将以 root 身份运行 Metricbeat,因此您需要更改配置文件和在 |
您将以 root 身份运行 Metricbeat,因此您需要更改配置文件和在 |
PS C:\Program Files\metricbeat> Start-Service metricbeat
默认情况下,Windows 日志文件存储在 C:\ProgramData\metricbeat\Logs
中。
在 Windows 上,目前未捕获有关系统负载和交换使用情况的统计信息
Metricbeat 应开始将指标流式传输到 Elasticsearch。
步骤 6:在 Kibana 中查看您的数据
编辑Metricbeat 带有预构建的 Kibana 仪表板和 UI,用于可视化日志数据。您在之前运行 setup
命令时加载了仪表板。
要打开仪表板
-
启动 Kibana
- 登录到您的 Elastic Cloud 帐户。
- 导航到您的部署中的 Kibana 端点。
将您的浏览器指向 https://127.0.0.1:5601,将
localhost
替换为 Kibana 主机的名称。 -
在侧面导航中,单击 Discover。要查看 Metricbeat 数据,请确保选择了预定义的
metricbeat-*
数据视图。如果在 Kibana 中看不到数据,请尝试将时间过滤器更改为更大的范围。默认情况下,Kibana 显示最近 15 分钟的数据。
- 在侧边导航栏中,单击 仪表板,然后选择要打开的仪表板。
仪表板仅作为示例提供。我们建议您自定义它们以满足您的需求。
下一步是什么?
编辑既然您的基础设施指标正在流入 Elasticsearch,请学习如何统一您的日志、指标、正常运行时间和应用程序性能数据。