logstash-plugins/logstash-filter-grok

# Logstash 插件 [](https://travis-ci.com/logstash-plugins/logstash-filter-grok) 这是 [Logstash](https://github.com/elastic/logstash) 的一个插件。 它完全免费且完全开源。许可证是 Apache 2.0，这意味着你几乎可以以任何方式自由使用它。 ## 文档 Logstash 提供基础设施来自动生成此插件的文档。我们使用 asciidoc 格式编写文档，因此源代码中的任何注释都会首先被转换为 asciidoc，然后再转换为 HTML。所有插件文档都放置在一个 [集中位置](http://www.elastic.co/guide/en/logstash/current/)。 - 要格式化代码或配置示例，可以使用 asciidoc `[source,ruby]` 指令 - 有关更多 asciidoc 格式设置技巧，请参阅以下优秀参考：https://github.com/elastic/docs#asciidoc-guide ## 需要帮助？ 需要帮助吗？尝试访问 freenode IRC 上的 #logstash 或 https://discuss.elastic.co/c/logstash 讨论论坛。 ## 开发 ### 1. 插件开发与测试 #### 代码 - 要开始，你需要安装 Bundler gem 的 JRuby。 - 从 GitHub [logstash-plugins](https://github.com/logstash-plugins) 组织创建一个新插件或克隆一个现有的插件。我们也提供 [示例插件](https://github.com/logstash-plugins?query=example)。 - 安装依赖项 ``` bundle install ``` #### 测试 - 更新依赖项 ``` bundle install ``` - 运行测试 ``` bundle exec rspec ``` ### 2. 在 Logstash 中运行未发布的插件 #### 2.1 在本地 Logstash 克隆中运行 - 编辑 Logstash 的 `Gemfile` 并添加本地插件路径，例如： ``` gem "logstash-filter-awesome", :path => "/your/local/logstash-filter-awesome" ``` - 安装插件 ``` # Logstash 2.3 and higher bin/logstash-plugin install --no-verify # Prior to Logstash 2.3 bin/plugin install --no-verify ``` - 使用你的插件运行 Logstash ``` bin/logstash -e 'filter {awesome {}}' ``` 此时，对插件代码的任何修改都将应用于此本地 Logstash 设置。修改插件后，只需重新运行 Logstash 即可。 #### 2.2 在已安装的 Logstash 中运行 你可以使用相同的 **2.1** 方法在已安装的 Logstash 中运行你的插件，方法是编辑其 `Gemfile` 并将 `:path` 指向你的本地插件开发目录，或者你可以构建 gem 并使用以下方式安装： - 构建你的插件 gem ``` gem build logstash-filter-awesome.gemspec ``` - 从 Logstash 主目录安装插件 ``` # Logstash 2.3 and higher bin/logstash-plugin install --no-verify # Prior to Logstash 2.3 bin/plugin install --no-verify ``` - 启动 Logstash 并测试插件 ## 贡献 欢迎所有贡献：想法、补丁、文档、错误报告、抱怨，甚至是你在餐巾纸上画出的东西。 编程不是必需的技能。无论你听说过关于开源和维护者或社区成员“发送补丁否则就滚”的说法——在这里你都不会看到这些。 对社区来说，更重要的是你能够做出贡献。 有关更多贡献信息，请参阅 [CONTRIBUTING](https://github.com/elastic/logstash/blob/master/CONTRIBUTING.md) 文件。

标签：Apache 2.0 许可证, Asciidoc, Elastic Stack, Grok 插件, Grok 过滤, Logstash 开发, Logstash 插件, Logstash 过滤插件, SEO 关键词, 内容过滤, 开源插件, 插件开发, 搜索引擎优化, 数据结构化, 文档自动生成, 日志处理, 日志格式解析, 日志结构化, 日志解析, 日志采集, 正则解析日志, 流量重放, 证书伪造, 默认DNS解析器