New Relic Infrastructure Agent 設定の基礎と最適化指針 ​

# /etc/newrelic-infra.yml - 最小限の設定例

# 必須設定（これだけで動きます）
license_key: YOUR_LICENSE_KEY  # 取得方法: New Relic UI > API Keys > Ingest - License

# 推奨設定（識別を簡単にするため）
display_name: "web-server-01"  # ダッシュボードで表示される名前

# /etc/newrelic-infra.yml - プロダクション用完全設定

# ==================== 基本設定 ====================
license_key: ${NEW_RELIC_LICENSE_KEY}  # 環境変数から取得
display_name: ${HOSTNAME}  # 環境変数から取得。省略するとホスト名が自動設定されます
verbose: 0  # 本番環境では通常レベル（0=normal, 1=verbose, 2=debug, 3=trace）

# ==================== ネットワーク設定 ====================
# プロキシ設定（企業環境で必要な場合）
proxy: ${HTTPS_PROXY}  # 例: http://proxy.company.com:8080

# SSL/TLS証明書設定（企業環境で必要な場合）
# ca_bundle_file: /etc/pki/ca-trust/source/anchors/company-ca.crt
# ca_bundle_dir: /etc/ssl/certs

# プロキシ認証が必要な場合
# proxy: http://username:[email protected]:8080

# コレクターURL（リージョン別設定）
# fedramp: true  # FedRAMP対応の場合
# collector_url: https://infra-api.eu01.nr-data.net  # EUリージョンの場合

# ==================== パフォーマンス設定 ====================
# サンプリングレート（秒単位）
metrics_network_sample_rate: 10  # ネットワークメトリクス
metrics_process_sample_rate: 20  # プロセスメトリクス
metrics_storage_sample_rate: 20  # ストレージメトリクス
metrics_system_sample_rate: 20   # システムメトリクス

# ==================== プロセス監視設定 ====================
# コマンドライン引数の除外（セキュリティ）
strip_command_line: true

# 特定プロセスの除外
exclude_matching_processes:
  - "sshd"       # SSH接続を除外
  - "systemd-*"  # systemd関連プロセスを除外

# ==================== ログ設定 ====================
log:
  file: /var/log/newrelic-infra/newrelic-infra.log
  to_stdout: false  # 標準出力への出力（コンテナ環境では true に設定）

# ==================== カスタム属性 ====================
custom_attributes:
  environment: ${ENVIRONMENT:-production}
  service: ${SERVICE_NAME:-web}
  team: ${TEAM:-infrastructure}
  region: ${AWS_REGION:-ap-northeast-1}
  datacenter: ${DATACENTER:-tokyo}
  deployment_method: ansible
  monitoring_tier: premium

# ==================== インベントリ収集設定 ====================
# インベントリ情報は自動的に1時間ごとに収集されます
# 無効化する場合のみ以下を追加：
# disable_inventory: true

# ==================== フィルタリング設定 ====================
# ネットワークインターフェースのフィルタリング
network_interface_filters:
  exclude:
    - "lo"          # ループバック
    - "docker.*"    # Dockerネットワーク
    - "veth.*"      # 仮想ネットワーク

# ファイルシステムのフィルタリング
file_devices_blacklist:
  - "tmpfs"       # 一時ファイルシステム
  - "devtmpfs"    # デバイスファイルシステム

# ==================== ホストエイリアス設定 ====================
# クラウド環境での動的ホスト名対応
host_aliases:
  - "${INSTANCE_ID}"
  - "${PRIVATE_IP}"

# ==================== 統合機能の設定 ====================
# 統合機能（On-Host Integrations）の設定は /etc/newrelic-infra/integrations.d/ に配置
# 例: /etc/newrelic-infra/integrations.d/nginx-config.yml
# 統合機能の一括無効化（必要に応じて）：
# disable_all_plugins: true

# カスタム属性の実用例
custom_attributes:
  # 環境識別
  env: production
  env_tier: gold  # gold, silver, bronze
  
  # サービス情報
  service: payment-api
  service_version: 2.1.0
  
  # チームと責任
  team: platform-engineering
  owner: [email protected]
  cost_center: CC-1234
  
  # 地理情報
  region: asia-pacific
  datacenter: tokyo-01
  rack: A-12
  
  # コンプライアンス
  pci_compliant: true
  gdpr_scope: true
  
  # SLAレベル
  sla_tier: 99.99
  backup_policy: daily