Elasticsearch:自己管理型 APM サーバーを用いた Alibaba Cloud Elasticsearch へのデータ収集

APM サーバーのインストール

1. 一般ユーザとして ECS インスタンスに接続します。詳細については、「パスワードまたはキーペアを使用した Linux インスタンスへの接続」をご参照ください。

2. APM サーバーパッケージをダウンロードします。

   wget https://artifacts.elastic.co/downloads/apm-server/apm-server-7.10.2-linux-x86_64.tar.gz

3. パッケージを展開します。

   tar -zxf apm-server-7.10.2-linux-x86_64.tar.gz

APM サーバーの構成

1. APM サーバーのディレクトリに移動します。

   cd apm-server-7.10.2-linux-x86_64/

2. 構成ファイルを開きます。

   vim apm-server.yml

3. 構成を、ご利用の Elasticsearch クラスターの詳細情報に更新します。

   パラメーター	説明
   apm-server.host	APM サーバーがリッスンするアドレスとポート。フォーマット：<IP>:<ポート>。0.0.0.0:8200 を指定すると、すべてのインターフェイスでリッスンします。
   output.elasticsearch.hosts	Elasticsearch クラスターのエンドポイント。ECS インスタンスとクラスターが同一の仮想プライベートクラウド (VPC) 内にある場合は、内部エンドポイントを使用します。異なる VPC 内にある場合は、パブリックエンドポイントを使用し、パブリック IP アドレスホワイトリストを構成します。詳細については、「クラスターの基本情報を表示」および「Elasticsearch クラスターのパブリックまたはプライベート IP アドレスホワイトリストの構成」をご参照ください。
   output.elasticsearch.username	Elasticsearch のユーザー名。デフォルトは elastic です。カスタムアカウントを使用する場合は、まずロールを作成し、必要な書き込み権限を付与してください。詳細については、「Elasticsearch X-Pack が提供する RBAC メカニズムを用いたアクセス制御の実装」をご参照ください。
   output.elasticsearch.password	elastic アカウントのパスワードは、クラスター作成時に設定されます。パスワードを再設定する場合は、「Elasticsearch クラスターのアクセスパスワードの再設定」をご参照ください。

   apm-server:
     host: "0.0.0.0:8200"
   output.elasticsearch:
     hosts: ["es-cn-*****.elasticsearch.aliyuncs.com:9200"]
     username: "elastic"
     password: "<your-password>"

APM サーバーの起動

次のコマンドを実行して、APM サーバーをバックグラウンドで起動し、出力をログファイルにリダイレクトします。

nohup ./apm-server -e > apmserver.log 2>&1 &

APM サーバーが起動し、指定したエンドポイントの Elasticsearch に接続し、エージェント API をポート 8200 で公開します。サーバーが正しく実行中であることを確認するには、apmserver.log を確認し、Elasticsearch への接続完了およびポート 8200 でのリッスン開始を示すメッセージが記録されていることを確認してください。

Go エージェントのインストール

1. プロジェクト向けに Go モジュールを初期化します。

   sudo go mod init demo

2. APM エージェントパッケージをインストールします。

   golang.org xxxx: i/o timeout エラーが発生した場合、お使いの環境から golang.org への到達ができない状態です。再試行前に、Go モジュールプロキシを到達可能なミラーに変更してください。

   sudo go get go.elastic.co/apm
   sudo go get go.elastic.co/apm/module/apmhttp

APM エージェントの環境変数の設定

1. シェルプロファイルファイルを開きます。

   vim ~/.bash_profile

2. 以下の環境変数を追加し、ファイルを保存します。

   変数	デフォルト値	説明
   ELASTIC_APM_SERVICE_NAME	実行可能ファイル名	サービス名。使用可能な文字：英字、数字、ハイフン (-)、アンダースコア (_)、およびスペース。
   ELASTIC_APM_SERVER_URL	http://localhost:8200	APM サーバーの URL。ステップ 1 で起動したサーバーのアドレスを指定してください。
   ELASTIC_APM_SECRET_TOKEN	（なし）	APM サーバーで必要とされるシークレットトークン。

   export ELASTIC_APM_SERVICE_NAME=zijian
   export ELASTIC_APM_SERVER_URL=
   export ELASTIC_APM_SECRET_TOKEN=

3. 構成を適用します。

   source ~/.bash_profile

アプリケーションのインストルメンテーション

Elastic APM Go エージェントは、人気のあるフレームワーク（例：apmhttp）向けの組み込みモジュールおよびカスタムイベントトラッキング向けの低レベル Tracer API を提供します。本例では、標準 HTTP サーバーをラップするために apmhttp を使用します。

1. アプリケーションファイルを作成します。

   vim apm.go

2. 以下のコードを追加し、ファイルを保存します。

   package main
   
   import (
     "net/http"
   
     "go.elastic.co/apm/module/apmhttp"
   )
   
   func main() {
     mux := http.NewServeMux()
     http.ListenAndServe(":8080", apmhttp.Wrap(mux))
   }

3. アプリケーションを実行します。

   sudo go run apm.go

   アプリケーションが実行されると、APM エージェントはトレースデータを APM サーバーに送信し始め、APM サーバーはそのデータをご利用の Elasticsearch クラスターに転送します。

自動インデックス作成の有効化

Alibaba Cloud Elasticsearch ではインデックスの命名規則が強制されています。APM サーバーによって自動的に作成される APM オンボードインデックスは、これらの規則に準拠していないため、明示的に許可する必要があります。

1. Kibana コンソールにログインします。詳細については、「Kibana コンソールへのログイン」をご参照ください。

   本ガイドでは V7.10 クラスターを使用しています。他の Elasticsearch バージョンではログイン手順が異なる場合があります。

2. Kibana ホームページの右上隅にある Dev tools をクリックします。

3. [コンソール] タブで、次のコマンドを実行します。7.10.2 をインストールした APM サーバーのバージョンに置き換えます。

   PUT _cluster/settings
   {
     "persistent": {
       "action.auto_create_index":"+.*,+apm-7.10.2-onboarding-*,-*"
     }
   }

監視対象サービスの表示

1. 左上隅の アイコンをクリックしてナビゲーションウィンドウを展開します。

2. 可観測性 の下で、APM をクリックします。

3. Services タブで、APM エージェントにより監視中のすべてのサービスが一覧表示されます。

   

4. サービス名をクリックして、トレース、トランザクション、およびパフォーマンスデータをドリルダウン表示します。