newrelic_installer
モジュールを使用して、インフラストラクチャ エージェント、ログ統合、PHP APM エージェントをインストールして構成する方法を学びます。Puppet の使用方法の説明については、 Puppet のドキュメントを参照してください。これは コミュニティの支援による 取り組みです。
ここでは、この構成管理ツールを使用するために必要な基本的な情報を説明します。追加の構成は、組織の標準と実装によって異なります。
要件
Puppet モジュールには次の要件があります。
- パペット エンタープライズ 2023.1.x、2023.0.x、2021.7.x、2021.6.x、2021.5.x、2021.4.x、2021.3.x、2021.2.x、2021.1.x、2021.0.x、2019.8.x
- Puppet 6.21.0 以降、8.0.0 未満
- Debian、CentOS、OpenSUSE、RedHat、SLES、Ubuntu、Windows、Amazon Linux
モジュールの説明
newrelic-newrelic_installer
は、New Relic の可観測性への取り組みを拡張するのに役立つ Puppet モジュールです。これを実現するために、 New Relic CLI と オープン インストール リポジトリを使用します。
私たちの Puppet モジュールは Puppet Forgeで入手できます。
重要
特定のインフラストラクチャ エージェント バージョンのインストールはサポートされていません。この方法では、常に最新バージョンのエージェントがインストールされます。
モジュールを使ってインフラストラクチャ・エージェントをインストールします。
パペットフォージ
$puppet module install newrelic-newrelic_installer
PuppetForgeでその他のインストール オプションを表示する
手動
- Puppet 開発キットをインストールします: https://www.puppet.com/docs/pdk/2.x/pdk_install.html
- リポジトリのクローンを作成し、
pdk build
を使用してモジュールの tarball をビルドします。例えば、pkg/newrelic-newrelic_installer-0.1.0.tar.gz
- モジュール tarball をマスター ノードにコピーし、手動でインストールします。
$sudo puppet module install ~/newrelic-newrelic_installer-0.1.0.tar.gzNotice: Preparing to install into /etc/puppetlabs/code/environments/production/modules ...Notice: Downloading from https://forgeapi.puppet.com ...Notice: Installing -- do not interrupt .../etc/puppetlabs/code/environments/production/modules└─┬ newrelic-newrelic_installer (v0.1.0) ├── lwf-remote_file (v1.1.3) └── puppetlabs-powershell (v5.2.0)
走る newrelic-newrelic_installer
デフォルトの newrelic-newrelic_installer
モジュールを実行するには、インストルメンテーション ターゲットと New Relic アカウントの認証情報を使用してメインの ::install
クラスを宣言します。
# /etc/puppetlabs/code/environments/<YOUR_ENVIRONMENT>/manifests/site.ppclass { 'newrelic_installer::install': targets => ["infrastructure", "logs"], environment_variables => { "NEW_RELIC_API_KEY" => "<YOUR-NR-API-KEY>", "NEW_RELIC_ACCOUNT_ID" => <YOUR-NR-ACCOUNT-ID>, "NEW_RELIC_REGION" => "<US|EU>" }}
パペットのパラメータ
newrelic_installer::install
パブリッククラスのパラメータは次のとおりです。
パラメータ | タイプ | 必要とされている | パラメータの説明 |
---|---|---|---|
| 弦 | 必須 | New Relic をインストルメントするターゲットを指定します。 サポートされている値は次のとおりです。
|
| ハッシュ | 必須 | 実行前に設定する環境変数のハッシュ。
|
| 弦 | オプション | コマンド出力の冗長性を指定します サポートされている値は次のとおりです。
|
| ハッシュ | オプション | New Relic で計測されたエンティティに関連付けられたタグのハッシュ。例:
|
| 弦 | オプション | エージェントが使用するプロキシ サーバーを設定します。例:
|
| 整数 | オプション | New Relic インストールのタイムアウトを秒単位で設定します。デフォルトは |