2026年7月9日

WordPressのOpenTelemetryでトレーシングを設定する

サーバー・ホスティング

はじめに

この記事では、オープンソースのソフトウェア監視ツールであるOpenTelemetryをWordPress環境に導入する方法と、その設定手順について詳しく紹介します。OpenTelemetryは、分散システム全体のトレーシング、メトリクス収集、ログ記録を一元化し、複雑な問題解決やパフォーマンス最適化に貢献します。

症状・背景

このテーマが必要になる主な場面:

サイトのパフォーマンスが低下している
ユーザーからのエラーレポートが増えている
他のツールで不足する詳細なトレーシングデータを取得したい
OpenTelemetryを活用したモニタリング環境を構築したい

手順・設定方法

ステップ1: OpenTelemetry SDKのインストール

# パッケージリポジトリを追加
sudo apt-get install -y curl gnupg2
curl -s https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg
sudo mv microsoft.gpg /etc/apt/trusted.gpg.d/
sudo sh -c 'echo "deb [arch=amd64] https://packages.microsoft.com/repos/azuremonitor-linux stable main" > /etc/apt/sources.list.d/azure-monitor.list'

# OpenTelemetry SDKをインストール
sudo apt-get update
sudo apt-get install opentelemetry-collector-contrib

# サービスを起動し、自動起動設定
sudo systemctl enable opentelemetry-collector
sudo systemctl start opentelemetry-collector

ステップ2: WordPress用のOpenTelemetryコンフィギュレーションファイル作成

# OpenTelemetryのコンフィギュレーションファイルを作成
echo 'receivers:
  otlp:
    protocols:
      grpc:

exporters:
  logging:

service:
  pipelines:
    traces:
      receivers: [otlp]
      exporters: [logging]' > /etc/otel/config.yaml

# WordPress用にカスタマイズされたコンフィギュレーションファイルを作成
echo 'receivers:
  otlp:
    protocols:
      grpc:

exporters:
  logging:
  otlp/traces:
    endpoint: "localhost:4317"
    headers: ["Authorization=Bearer mytoken"]

service:
  pipelines:
    traces:
      receivers: [otlp]
      exporters: [logging, otlp/traces]' > /etc/otel/config-wordpress.yaml

ステップ3: WordPressのプラグインを使用してトレーシングを有効にする

# OpenTelemetry for PHPプラグインをWordPressにインストール
sudo composer require open-telemetry/opentelemetry-splunk-php --working-dir=/var/www/html/wp-content/plugins/

# プラグイン設定ファイルを作成
echo 'return array(
    "otlp_endpoint" => "http://localhost:4317",
);' > /var/www/html/wp-content/plugins/open-telemetry-for-php/config.php

# WordPressのプラグインを有効化
sudo wp plugin activate open-telemetry-for-php --allow-root

ステップ4: トレーシングデータの確認とモニタリング

# OpenTelemetry Collectorのログを確認
sudo journalctl -u opentelemetry-collector -f

注意事項

セキュリティトークンは適切に保護し、必要に応じて更新する。
パフォーマンス影響を最小限にするため、必要なトレーシングデータのみ収集するように設定を調整する。
利用しているOpenTelemetry Collectorのバージョンと互換性のあるWordPressプラグインを使用すること。

まとめ

1. パッケージリポジトリ追加: Microsoft Azure Monitorのリポジトリを追加し、最新版のOpenTelemetry SDKをインストール。

2. コンフィギュレーションファイル作成: WordPress用にカスタマイズされたOpenTelemetryの設定ファイルを作成する。

3. プラグイン利用: OpenTelemetry for PHPプラグインをWordPressにインストールし、トレーシング機能を有効にする。

4. モニタリング: コレクターのログを確認して、トレーシングデータが正しく収集されていることを検証する。

Post Views: 6