stacktonic.nr_infra

概要 バージョン 洞察

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（オプション）

インフラエージェントがインストールされるターゲット OS を指定します。デフォルトは ansible_os_family です。サポートされているオペレーティングシステムのリストについては、meta/main.yml ファイルを参照してください。

nrinfragent_os_version（オプション）

このマシンに必要なインストーラパッケージの OS バージョンを指定します。デフォルトは ansible_lsb.major_release です。主に RedHat ファミリーの OS 用です。サポートされているオペレーティングシステムのリストについては、meta/main.yml ファイルを参照してください。

nrinfragent_os_codename（オプション）

このマシンに必要なインストーラパッケージの OS コードネームを指定します。デフォルトは ansible_lsb.codename です。主に Debian ファミリーの OS 用です。サポートされているオペレーティングシステムのリストについては、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）を削除したい場合、最初の項目として nrinfragent_integrations に newrelic-infra-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 のサポートは、第三者の newrelic-infra Chocolatey パッケージ に依存しており、このパッケージは @ripclawffb と @xandrellas によって維持されています。これは、New Relic からの保証やサポートなしに配布されています。

Ansible Galaxy へのリリース

Ansible Galaxy へ新しいバージョンをリリースするには、次の手順に従ってください：

  • CHANGELOG.md を更新します。
  • 新しい GitHub リリースを作成します。
  • バージョンが Ansible Galaxy にインポートされていることを確認します。問題がある場合は、プロジェクトオーナーの一人に問い合わせてください。

サポート

New Relic 製品に関して支援が必要な場合は、いくつかのサポート診断ツールとサポートチャネルがありますのでご安心ください。

問題がバグとして確認された場合や機能リクエストの場合は、GitHub 問題を提出してください。

サポートチャネル

プライバシー

New Relic では、お客様のプライバシーと情報のセキュリティを真剣に考え、顧客情報の保護に努めています。個人データを公のフォーラムで共有しないことの重要性を強調し、全てのユーザーに対して個人情報、機密情報、その他の機密情報を含まないようにログや診断情報を注意深く確認することをお願いしています。

「個人データ」とは、特定されたまたは特定可能な個人に関連する情報、たとえば名前、電話番号、郵便番号、デバイスID、IPアドレス、メールアドレスなどを指します。

詳細については、New Relic の一般データプライバシー通知を確認してください。

貢献

このプロジェクトを改善するための貢献を歓迎します！プルリクエストを送信する際は、CLA-Assistant を使用してのクリック承認が必要です。プロジェクトごとに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
所有者