› ›

Timber 输出插件

编辑

Timber 输出插件编辑

插件版本：v1.0.3
发布日期：2017-09-02
变更日志

有关其他版本，请参阅版本化插件文档。

安装编辑

对于默认情况下未捆绑的插件，可以通过运行 bin/logstash-plugin install logstash-output-timber 轻松安装。有关更多详细信息，请参阅使用插件。

获取帮助编辑

有关插件的问题，请在讨论论坛中发布主题。对于错误或功能请求，请在 Github 中打开问题。有关 Elastic 支持的插件列表，请参阅 Elastic 支持矩阵。

描述编辑

此输出将结构化事件发送到 Timber.io 日志服务。Timber 是一款为开发人员设计的基于云的日志服务，提供开箱即用的简便功能，使您提高工作效率。跟踪用户、跟踪请求、检查 HTTP 参数以及搜索丰富的结构化数据，而不会牺牲可读性。

在内部，它是一种高效的 HTTP 传输，使用批处理和重试来实现快速可靠的交付。

此输出将并行执行最多 pool_max 个请求以提高性能。在为性能调整此插件时请考虑这一点。对于大多数设置，默认值 50 应该足够了。

此外，请注意，当使用并行执行时，无法保证事件的严格排序！

Timber 输出配置选项编辑

此插件支持以下配置选项，以及后面描述的通用选项。

设置	输入类型	必需
`api_key`	您的 Timber.io API 密钥	否
`cacert`	有效的系统路径	否
`client_cert`	有效的系统路径	否
`client_key`	有效的系统路径	否
`connect_timeout`	数字	否
`keystore`	有效的系统路径	否
`keystore_password`	密码	否
`keystore_type`	字符串	否
`pool_max`	数字	否
`proxy`	<<,>>	否
`request_timeout`	数字	否
`socket_timeout`	数字	否
`truststore`	有效的系统路径	否
`truststore_password`	密码	否
`truststore_type`	字符串	否

另请参阅通用选项，了解所有输出插件支持的选项列表。

`api_key`编辑

值类型为字符串
此设置没有默认值。

您的 Timber.io API 密钥。您可以在 [Timber 控制台](https://app.timber.io) 中创建应用程序以获取您的 API。

`cacert`编辑

值类型为路径
此设置没有默认值。

如果您需要使用自定义 X.509 CA（.pem 证书），请在此处指定该路径。

`client_cert`编辑

值类型为路径
此设置没有默认值。

如果您想使用客户端证书（请注意，大多数人都不希望这样做），请在此处设置 x509 证书的路径。

`client_key`编辑

值类型为路径
此设置没有默认值。

如果您使用的是客户端证书，请在此处指定加密密钥的路径。

`connect_timeout`编辑

值类型为数字
默认值为 10

等待建立连接的超时时间（以秒为单位）。默认值为 10s

`keystore`编辑

值类型为路径
此设置没有默认值。

如果您需要使用自定义密钥库（.jks），请在此处指定它。这与 .pem 密钥不兼容！

`keystore_password`编辑

值类型为密码
此设置没有默认值。

在此处指定密钥库密码。请注意，大多数使用 keytool 创建的 .jks 文件都需要密码！

`keystore_type`编辑

值类型为字符串
默认值为 "JKS"

在此处指定密钥库类型。可以是 JKS 或 PKCS12。默认值为 JKS

`pool_max`编辑

值类型为数字
默认值为 50

最大并发连接数。默认为 50

`proxy`编辑

值类型为字符串
此设置没有默认值。

如果您想使用 HTTP 代理。这支持多种配置语法。

代理主机形式：http://proxy.org:1234
代理主机形式：{host => "proxy.org", port => 80, scheme => 'http', user => 'username@host', password => 'password'}
代理主机形式：{url => 'http://proxy.org:1234', user => 'username@host', password => 'password'}

`request_timeout`编辑

值类型为数字
默认值为 60

此模块使您可以轻松地基于 [Manticore](https://github.com/cheald/manticore) 向 logstash 添加一个配置非常完整的 HTTP 客户端。有关其用法的示例，请参阅 https://github.com/logstash-plugins/logstash-input-http_poller 整个请求的超时时间（以秒为单位）。

`socket_timeout`编辑

值类型为数字
默认值为 10

等待套接字上数据的超时时间（以秒为单位）。默认值为 10s

`ssl_certificate_validation`编辑

值类型为布尔值
默认值为 true

将其设置为 false 以禁用 SSL/TLS 证书验证。注意：将其设置为 false 通常被认为是不安全的！

`truststore`编辑

值类型为路径
此设置没有默认值。

如果您需要使用自定义信任库（.jks），请在此处指定它。这与 .pem 证书不兼容！

`truststore_password`编辑

值类型为密码
此设置没有默认值。

在此处指定信任库密码。请注意，大多数使用 keytool 创建的 .jks 文件都需要密码！

`truststore_type`编辑

值类型为字符串
默认值为 "JKS"

在此处指定信任库类型。可以是 JKS 或 PKCS12。默认值为 JKS

通用选项编辑

以下配置选项由所有输出插件支持。

设置	输入类型	必需
`enable_metric`	布尔值	否
`id`	字符串	否

`enable_metric`编辑

值类型为布尔值
默认值为 true

禁用或启用此特定插件实例的指标日志记录。默认情况下，我们会记录所有可能的指标，但您可以禁用特定插件的指标收集。

`id`编辑

值类型为字符串
此设置没有默认值。

在插件配置中添加一个唯一的 ID。如果未指定 ID，Logstash 将生成一个 ID。强烈建议您在配置中设置此 ID。当您有两个或多个相同类型的插件时，这尤其有用。例如，如果您有两个 timber 输出。在这种情况下，添加一个命名 ID 将有助于在使用监控 API 时监控 Logstash。

output {
  timber {
    id => "my_plugin_id"
  }
}

id 字段中的变量替换仅支持环境变量，不支持使用来自秘密存储的值。

« Tcp 输出插件 Udp 输出插件 »

Timber 输出插件

Timber 输出插件编辑

安装编辑

获取帮助编辑

描述编辑

Timber 输出配置选项编辑

api_key编辑

cacert编辑

client_cert编辑

client_key编辑

connect_timeout编辑

keystore编辑

keystore_password编辑

keystore_type编辑

pool_max编辑

proxy编辑

request_timeout编辑

socket_timeout编辑

ssl_certificate_validation编辑

truststore编辑

truststore_password编辑

truststore_type编辑