Heartbeat 快速入门：安装和配置

本指南介绍如何快速开始收集有关主机正常运行时间的的数据。您将学习如何

开始之前edit

您需要 Elasticsearch 来存储和搜索您的数据，以及 Kibana 来可视化和管理它。

步骤 1：安装 Heartbeatedit

与您在边缘节点上安装的大多数 Beats 不同，您通常将 Heartbeat 安装为在单独的机器上运行的监控服务的组成部分，并且可能甚至在您要监控的服务所在的网络之外运行。

要下载和安装 Heartbeat，请使用适合您系统的命令

curl -L -O https://artifacts.elastic.co/downloads/beats/heartbeat/heartbeat-8.14.3-amd64.deb
sudo dpkg -i heartbeat-8.14.3-amd64.deb

curl -L -O https://artifacts.elastic.co/downloads/beats/heartbeat/heartbeat-8.14.3-x86_64.rpm
sudo rpm -vi heartbeat-8.14.3-x86_64.rpm

curl -L -O https://artifacts.elastic.co/downloads/beats/heartbeat/heartbeat-8.14.3-darwin-x86_64.tar.gz
tar xzvf heartbeat-8.14.3-darwin-x86_64.tar.gz

curl -L -O https://artifacts.elastic.co/downloads/beats/heartbeat/heartbeat-8.14.3-linux-x86_64.tar.gz
tar xzvf heartbeat-8.14.3-linux-x86_64.tar.gz

显示的命令适用于 AMD 平台，但 ARM 包也可用。有关可用包的完整列表，请参阅 下载页面。

其他安装选项edit

步骤 2：连接到 Elastic Stackedit

需要与 Elasticsearch 和 Kibana 建立连接才能设置 Heartbeat。

在 heartbeat.yml 中设置连接信息。要找到此配置文件，请参阅 目录布局。

cloud.id: "staging:dXMtZWFzdC0xLmF3cy5mb3VuZC5pbyRjZWM2ZjI2MWE3NGJmMjRjZTMzYmI4ODExYjg0Mjk0ZiRjNmMyY2E2ZDA0MjI0OWFmMGNjN2Q3YTllOTYyNTc0Mw=="
cloud.auth: "heartbeat_setup:YOUR_PASSWORD" 

要了解有关所需角色和权限的更多信息，请参阅 授予用户访问受保护资源的权限。

步骤 3：配置 Heartbeat 监控器edit

Heartbeat 提供监控器来以设定的间隔检查主机状态。Heartbeat 目前提供 ICMP、TCP 和 HTTP 的监控器（有关这些监控器的更多信息，请参阅 Heartbeat 概述）。

您分别配置每个监控器。在 heartbeat.yml 中，指定您要启用的监控器列表。列表中的每个项目都以短划线 (-) 开头。以下示例配置 Heartbeat 以使用三个监控器：一个 icmp 监控器、一个 tcp 监控器和一个 http 监控器。

heartbeat.monitors:
- type: icmp
  schedule: '*/5 * * * * * *' 
  hosts: ["myhost"]
  id: my-icmp-service
  name: My ICMP Service
- type: tcp
  schedule: '@every 5s' 
  hosts: ["myhost:12345"]
  mode: any 
  id: my-tcp-service
- type: http
  schedule: '@every 5s'
  urls: ["http://example.net"]
  service.name: apm-service-name 
  id: my-http-service
  name: My HTTP Service

有关配置 Heartbeat 的更多信息，另请参阅

步骤 4：配置 Heartbeat 位置edit

Heartbeat 可以部署在多个位置，这样您就可以检测到这些位置之间的可用性和响应时间差异。配置 Heartbeat 位置以允许 Kibana 在 Uptime 地图上显示特定于位置的信息，并根据位置执行 Uptime 异常检测。

要配置 Heartbeat 实例的位置，请修改 heartbeat.yml 中的 add_observer_metadata 处理器。以下示例将 add_observer_metadata 处理器的 geo.name 指定为 us-east-1a

# ============================ Processors ============================

processors:
  - add_observer_metadata:
      # Optional, but recommended geo settings for the location Heartbeat is running in
      geo: 
        # Token describing this location
        name: us-east-1a 
        # Lat, Lon "
        #location: "37.926868, -78.024902" 

有关配置 Heartbeat 的更多信息，另请参阅

步骤 5：设置资产edit

Heartbeat 附带用于解析、索引和可视化数据的预定义资产。要加载这些资产

此步骤加载用于写入 Elasticsearch 的推荐 索引模板。它不会安装 Heartbeat 仪表板。Heartbeat 仪表板和安装步骤可在 uptime-contrib GitHub 存储库中找到。

步骤 6：启动 Heartbeatedit

在启动 Heartbeat 之前，请修改 heartbeat.yml 中的用户凭据，并指定 有权发布事件 的用户。

要启动 Heartbeat，请运行

sudo service heartbeat-elastic start

sudo service heartbeat-elastic start

sudo chown root heartbeat.yml 
sudo ./heartbeat -e

sudo chown root heartbeat.yml 
sudo ./heartbeat -e

PS C:\Program Files\heartbeat> Start-Service heartbeat

Heartbeat 现在已准备好检查您的服务的状况并将事件发送到您定义的输出。

步骤 7：在 Kibana 中查看您的数据edit

Heartbeat 提供预构建的 Kibana 仪表盘和 UI 用于可视化服务状态。这些仪表盘可在 uptime-contrib GitHub 仓库中找到。

如果您之前已加载仪表盘，现在可以打开它们。

要打开仪表盘：

这些仪表盘是示例，我们建议您根据需要 定制它们。

下一步：编辑

现在您已经将正常运行时间数据流式传输到 Elasticsearch，了解如何统一您的日志、指标、正常运行时间和应用程序性能数据。