stacktonic.nr_infra

概述 版本 洞察

New Relic Community Plus 头图

用于 New Relic 基础设施代理的 Ansible 角色 构建状态

此角色用于安装和配置 New Relic 基础设施代理。

请注意，这只是一个简单的角色，旨在作为您定制工作流的起点。

安装和使用 Ansible 角色

newrelic-infra 的影响

  • 添加 New Relic 的软件包仓库源。
  • 安装并配置 New Relic 基础设施代理。

开始使用该角色

首先在您的剧本中包含该角色并自定义所需的变量。

通过角色配置完成与 newrelic-infra 的所有典型交互。

使用该角色安装基础设施代理

使用以下代码片段安装代理。

---
- hosts: ap_ne_1
  roles:
    - name: newrelic.newrelic-infra
      vars:
        nrinfragent_config:
          license_key: YOUR_LICENSE_KEY
          log_file: /var/log/nr-infra.log
          log_to_stdout: false

参考

角色配置

变量

nrinfragent_config（必需）

用于填写代理配置。至少必须提供 license_key。有关当前配置选项，请参见 New Relic 文档。

nrinfragent_state（可选）

描述您希望对代理执行的操作：

  • 'latest' - [默认] 安装最新版本的代理，也可用 present。
  • 'absent' - 卸载代理。
nrinfragent_os_name（可选）

指定要安装基础设施代理的目标操作系统。默认值为 ansible_os_family。对于支持的操作系统列表，请参见 meta/main.yml 文件。

nrinfragent_os_version（可选）

指定此机器所需安装包的操作系统版本。默认值为 ansible_lsb.major_release。主要用于 RedHat 家族操作系统。对于支持的操作系统列表，请参见 meta/main.yml 文件。

nrinfragent_os_codename（可选）

指定此机器所需安装包的操作系统代号。默认值为 ansible_lsb.codename。主要用于 Debian 家族操作系统。对于支持的操作系统列表，请参见 meta/main.yml 文件。

nrinfragent_choco_version（可选）

指定在 Windows 上安装 newrelic-infra 的 Chocolatey 包版本。可用于锁定版本或升级代理。

nrinfragent_service_state（可选）

指定安装后 newrelic-infra 服务的状态。默认值为 started，确保服务正在运行。您可以将其更改为 stopped 以仅安装服务，而不立即启动。

nrinfragent_service_enabled（可选）

指定服务在启动时是否会启动。默认值为 yes；将其更改为 no 以防止服务在启动时自动启动。

nrinfragent_integrations（可选）

指定要安装的基础设施集成。可用集成的列表可以在 这里 找到。

每个包应提供其 name 和 state。集成包名称位于 单个集成文档 的 安装和激活 部分。按惯例，其名称为服务名称加上 nri- 前缀（例如 nri-apache，nri-redis 等）。

默认情况下状态为 absent，不会安装包；您可以将其更改为 latest 或 present。例如：

nrinfragent_integrations:
  - { name: nri-nginx, state: "latest" }
  - { name: nri-mysql, state: "absent" }

每个集成的源代码可以在 newrelic 的 GitHub 组织 中找到。

删除 newrelic-infra-integrations 包及其捆绑集成

这仅适用于已安装 newrelic-infra-integrations 包的情况

如果您希望删除 newrelic-infra-integrations 包或任何捆绑集成（如 nri-redis、nri-cassandra、nri-apache、nri-nginx、nri-mysql），请将 newrelic-infra-integrations 作为 nrinfragent_integrations 的第一个项目，状态设置为 absent。

nrinfragent_integrations:
  - { name: newrelic-infra-integrations, state: "absent" }
不推荐使用

您可以为向后兼容性指定许可证密钥。我们建议您在 nrinfragent_config 中使用 license_key。如果两者都指定，nrinfragent_config 中的将优先。

兼容性

平台

  • RHEL/CentOS
    • RHEL/CentOS 8
    • RHEL/CentOS 7
    • RHEL/CentOS 6
    • RHEL/CentOS 5
  • Ubuntu
    • 18 Bionic
    • 16 Xenial
    • 14 Trusty
    • 12 Precise
  • Debian
    • 10 Buster
    • 9 Stretch
    • 8 Jessie
    • 7 Wheezy
  • SUSE Linux Enterprise
    • 12
  • Windows
    • 所有版本
    • _免责声明_：Windows 支持依赖于由 @ripclawffb 和 @xandrellas 维护的第三方 newrelic-infra Chocolatey 包，不提供任何保证或支持。

发布到 Ansible Galaxy

要将新版本发布到 Ansible Galaxy，请遵循以下步骤：

  • 更新 CHANGELOG.md
  • 创建新的 GitHub 版本。
  • 确保版本已导入 Ansible Galaxy；如有问题，请联系项目所有者。

支持

如果您需要有关 New Relic 产品的帮助，您可以使用多种支持诊断工具和支持渠道。

如果问题已确认是错误或功能请求，请提交 GitHub 问题。

支持渠道

隐私

我们在 New Relic 非常重视您的隐私和信息安全，并致力于保护您的信息。我们必须强调在公共论坛中不分享个人数据的重要性，并要求所有用户删除日志和诊断信息中的敏感信息，无论是个人的、专有的还是其他信息。

我们将“个人数据”定义为与已识别或可识别的个人相关的任何信息，包括，例如，您的姓名、电话号码、邮政编码、设备 ID、IP 地址和电子邮件地址。

有关更多信息，请参考 New Relic 的一般数据隐私通知。

贡献

我们鼓励您为改进该项目做出贡献！请记住，当您提交拉取请求时，您需要通过 CLA-Assistant 点击认证来签署 CLA。每个项目仅需签署一次 CLA。

如果您有任何问题，或需要执行我们的公司 CLA（如果您代表公司贡献），请通过 opensource@newrelic.com 给我们发送电子邮件。

关于漏洞的说明

正如我们在 安全政策 中指出的，New Relic 致力于保护我们的客户及其数据的隐私和安全。我们认为，提供协调披露给安全研究人员以及与安全社区的互动是实现我们的安全目标的重要手段。

如果您认为在该项目或任何 New Relic 产品或网站中发现了安全漏洞，我们欢迎并非常感激您通过 HackerOne 向 New Relic 报告。

如果您愿意为该项目做出贡献，请查看 这些指南。

感谢所有贡献者！没有你们的贡献，这个项目不会是今天的样子。

许可证

infrastructure-agent-ansible 采用 Apache 2.0 许可证。

关于项目

Role to install New Relic Infrastructure agent

role cloud ec2 monitoring system
安装
ansible-galaxy install stacktonic.nr_infra
GitHub 仓库
0 星标
0 分叉
0 未解决问题
许可证
apache-2.0
下载
199
拥有者