配置轻量级监控

type
("http" | "icmp" | "tcp")

必需。要运行的监控类型。以下之一：

id
(字符串)

必需。此配置的唯一标识符。无论对监控配置进行任何更改（无论对任何配置字段进行何种更改），此标识符都不应更改。

示例:

id: uploader-service

id: http://example.net

name
(字符串)

此监控的人类可读名称。

示例:

name: Uploader service

name: Example website

service.name
(字符串)

此监控的 APM 服务名称。对应于 service.name ECS 字段。在监控也使用 APM 的应用程序时设置此值，以启用 Kibana 中 Synthetics 和 APM 数据之间的集成。

enabled
(布尔值)

监控是否已启用。

默认值: true

示例:

enabled: false

schedule
(持续时间)

必需。任务计划。

示例:
从监控启动时间起，每 5 分钟运行一次任务。

schedule: @every 5m

timeout
(持续时间)

每个 ping 测试的总运行时间。这是允许测试连接和交换数据的总时间。

默认值: 16s

示例:

timeout: 2m

tags
(字符串 列表)

将与监控事件一起发送的标签列表。

示例:

tags:
  - tag one
  - tag two

tags: ["tag one", "tag two"]

mode
("any" | "all")

运行监控的两种模式之一

默认值: any

示例:
如果您使用 DNS 负载均衡器并希望 ping 指定主机名的每个 IP 地址，则应使用 all。

ipv4
(布尔值)

如果配置了主机名，是否使用 ipv4 协议进行 ping。

默认值: true

示例:

ipv4: false

ipv6
(布尔值)

如果配置了主机名，是否使用 ipv6 协议进行 ping。

默认值: true

示例:

ipv6: false

alert

启用或禁用此监控的警报。有关警报的更多信息，请参阅 警报。

retest_on_failure
(布尔值)

启用或禁用监控失败时的重新测试。默认值为 true。

默认情况下，如果监控从“正常”变为“故障”，则会自动重新测试监控。如果重新测试的结果也是“故障”，则会创建错误，如果已配置，则会发送警报。然后，监控将根据定义的计划恢复运行。使用 retestOnFailure 可以减少与瞬态问题相关的噪音。

示例:

retest_on_failure: false

locations
(SyntheticsLocationsType 列表)

监控部署位置。您可以在多个位置部署监控，以检测这些位置之间可用性和响应时间的差异。

要列出可用位置，您可以

示例:

locations: ["japan", "india"]

locations:
  - japan
  - india

private_locations
(字符串 列表)

监控将部署到的专用位置。这些专用位置是指您托管和管理的位置，而locations由Elastic托管。您可以使用位置的名称指定专用位置。

要列出可用的专用位置，您可以

示例:

private_locations: ["Private Location 1", "Private Location 2"]

private_locations:
  - Private Location 1
  - Private Location 2

fields

将在每个监控事件中发送的一组键值对。
这些fields作为labels追加到Elasticsearch文档中，
并且这些标签在Kibana的监控详情面板中显示在
各个监控的概览选项卡中.

示例:

fields:
  foo: bar
  team: synthetics

fields.foo: bar
fields.team: synthetics

hosts
(字符串)

必需。要 ping 的 URL。

max_redirects
（数字）

Synthetics将遵循的重定向总数。

默认情况下，Synthetics不会遵循重定向，但会报告重定向的状态。如果设置为大于0的数字，Synthetics将遵循该数量的重定向。

当此选项设置为大于0的值时，将不再报告monitor.ip字段，因为跨多个IP的多个DNS请求可能会返回多个IP。细粒度的网络计时数据也不会被记录，因为重定向中的数据将跨越多个请求。具体来说，字段http.rtt.content.us、http.rtt.response_header.us、http.rtt.total.us、http.rtt.validate.us、http.rtt.write_request.us和dns.rtt.us将被省略。

默认值：0

proxy_headers

在CONNECT请求期间发送到代理的附加标头。

proxy_url
(字符串)

HTTP代理URL。此设置是可选的。

示例:

http://proxy.mydomain.com:3128

username
(字符串)

用于对服务器进行身份验证的用户名。凭据与请求一起传递。此设置是可选的。

当您的check.response设置需要时，您需要指定凭据。例如，您可以检查403响应（check.response.status: [403]），而无需设置凭据。

password
(字符串)

用于对服务器进行身份验证的密码。此设置是可选的。

ssl
（SSL）

与HTTPS端点一起使用的TLS/SSL连接设置。如果您未指定设置，则使用系统默认值。

示例:

- type: http
  id: my-http-service
  name: My HTTP Service
  hosts: "https://myhost:443"
  schedule: '@every 5s'
  ssl:
    certificate_authorities: ['/etc/ca.crt']
    supported_protocols: ["TLSv1.0", "TLSv1.1", "TLSv1.2"]

headers
(布尔值)

控制HTTP响应标头http.response.body.headers字段的索引。将response.include_headers设置为false以禁用。

默认值: true

response

控制HTTP响应正文内容到http.response.body.contents字段的索引。

check

hosts
(字符串)

必需。要 ping 的主机。

示例:

hosts: "myhost"

wait
(持续时间)

如果未收到响应，则在发出另一个ICMP回显请求之前等待的持续时间。

默认值：1s

示例:

wait: 1m

hosts
(字符串)

必需。要 ping 的主机。该值可以是

示例:

hosts: "localhost:8000"

hosts: "tcp://127.0.0.1:8000"

check

一个可选的有效负载字符串，用于发送到远程主机以及预期的答案。如果未指定有效负载，则如果连接尝试成功，则假定端点可用。如果指定了send但未指定receive，则任何响应都被接受为OK。如果指定了receive但未指定send，则不会发送任何有效负载，但客户端期望在连接时以“hello message”或“banner”的形式接收有效负载。

示例:

check.send: 'Hello World'
check.receive: 'Hello World'

check:
  send: 'Hello World'
  receive: 'Hello World'

proxy_url

连接到服务器时要使用的 SOCKS5 代理的 URL。该值必须是方案为 socks5:// 的 URL。

如果 SOCKS5 代理服务器需要客户端身份验证，则可以在 URL 中嵌入用户名和密码。

使用代理时，主机名是在代理服务器上解析的，而不是在客户端上解析的。可以通过设置proxy_use_local_resolver选项来更改此行为。

示例:

需要客户端身份验证的代理 URL

proxy_url: socks5://user:password@socks5-proxy:2233

proxy_use_local_resolver
(布尔值)

一个布尔值，用于确定主机名是在本地解析还是在代理服务器上解析。默认值为false，这意味着名称解析发生在代理服务器上。

默认值: false

ssl
（SSL）

TLS/SSL 连接设置。如果监视器配置为使用 SSL，它将尝试进行 SSL 握手。如果未配置check，则监视器将仅检查它是否可以建立 SSL/TLS 连接。此检查可能会在 TCP 层或证书验证期间失败。

示例:

ssl:
  certificate_authorities: ['/etc/ca.crt']
  supported_protocols: ["TLSv1.0", "TLSv1.1", "TLSv1.2"]

另请参阅配置 SSL，以获取ssl选项的完整描述。