問題
オンホスト ECS 統合を インストールして数分間待機しましたが、クラスターが エンティティ リストに表示されません。
重要
ECS 統合には、 クラウドベースの統合 とオンホスト統合の 2 つがあります。このドキュメントはオンホスト統合について説明しています。
解決
以前にインフラストラクチャ エージェントまたはインフラストラクチャ オンホスト統合をインストールしていた場合は、数分以内にデータが UI に表示されるはずです。
オンホスト ECS 統合をインストールする前にこれらの作業を行っていない場合は、データが UI に表示されるまでに数十分かかる場合があります。その場合は、最大 1 時間待ってから、次のトラブルシューティング手順を実行するか、サポートに連絡することをお勧めします。
データが表示されない場合のトラブルシューティングにはいくつかの方法があります。
- awscli ツールによるトラブルシューティング （New Relic のテクニカルサポートに相談する際にお勧めします。）
- UIによるトラブルシューティング
停止したタスクについての情報は、 停止したタスクの理由 を参照してください。
awscliによるトラブルシューティング
New Relic のサポートとやりとりする際には、この方法を使用し、生成されたファイルをサポートリクエストと一緒に送信してください。
newrelic-infraサイドカーを持つタスクを含むnewrelic-infraサービスまたは Fargate サービスに関連する情報を取得します。bash$aws ecs describe-services --cluster YOUR_CLUSTER_NAME --service newrelic-infra > newrelic-infra-service.jsonbash$aws ecs describe-services --cluster YOUR_CLUSTER_NAME --service YOUR_FARGATE_SERVICE_WITH_NEW_RELIC_SIDECAR > newrelic-infra-sidecar-service.jsonfailures属性は、サービスのエラーの詳細を示します。servicesの下にはstatus属性があります。サービスに問題がない場合はACTIVEと表示されます。desiredCountはrunningCountと一致する必要があります。これは、サービスが処理しているタスクの数です。デーモン サービス タイプを使用するため、クラスター内のコンテナー インスタンスごとに 1 つのタスクが必要です。すべてのタスクが実行されている必要があるため、pendingCount属性はゼロにする必要があります。servicesのevents属性を調べて、タスクのスケジュールまたは開始に関する問題を確認してください。例: サービスがタスクを正常に開始できない場合、次のようなメッセージが表示されます。{"id": "5295a13c-34e6-41e1-96dd-8364c42cc7a9","createdAt": "2020-04-06T15:28:18.298000+02:00","message": "(service newrelic-ifnra) is unable to consistently start tasks successfully. For more information, see the Troubleshooting section of the Amazon ECS Developer Guide."}同じセクションでは、イベントからサービスがどのタスクを開始したかを確認することもできます。
{"id": "1c0a6ce2-de2e-49b2-b0ac-6458a804d0f0","createdAt": "2020-04-06T15:27:49.614000+02:00","message": "(service fargate-fail) has started 1 tasks: (task YOUR_TASK_ID)."}このコマンドで、タスクに関連する情報を取得します。
bash$aws ecs describe-tasks --tasks YOUR_TASK_ID --cluster YOUR_CLUSTER_NAME > newrelic-infra-task.jsondesiredStatusとlastStatusはRUNNINGである必要があります。タスクが正常に開始できなかった場合、ステータスはSTOPPEDになります。stopCodeとstoppedReasonを調べます。1 つの理由の例: タスク実行ロールに、ライセンス キーを含むシークレットをダウンロードするための適切なアクセス許可がないために開始できなかったタスクの出力は、次のようになります。"stopCode": "TaskFailedToStart","stoppedAt": "2020-04-06T15:28:54.725000+02:00","stoppedReason": "Fetching secret data from AWS Secrets Manager in region YOUR_AWS_REGION: secret arn:aws:secretsmanager:YOUR_AWS_REGION:YOUR_AWS_ACCOUNT:secret:NewRelicLicenseKeySecret-Dh2dLkgV8VyJ-80RAHS-fail: AccessDeniedException: User: arn:aws:sts::YOUR_AWS_ACCOUNT:assumed-role/NewRelicECSIntegration-Ne-NewRelicECSTaskExecution-1C0ODHVT4HDNT/8637b461f0f94d649e9247e2f14c3803 is not authorized to perform: secretsmanager:GetSecretValue on resource: arn:aws:secretsmanager:YOUR_AWS_REGION:YOUR_AWS_ACCOUNT:secret:NewRelicLicenseKeySecret-Dh2dLkgV8VyJ-80RAHS-fail-DmLHfs status code: 400, request id: 9cf1881e-14d7-4257-b4a8-be9b56e09e3c","stoppingAt": "2020-04-06T15:28:10.953000+02:00",タスクが実行されているにもかかわらずデータが表示されない場合は、 verbose log を生成し、エラーがないか調べてください。
停止したタスクの理由の詳細については、 停止したタスク を参照してください。
UIでのトラブルシューティング
UIを使ってトラブルシューティングするには
AWSコンソールにログインし、「EC2 Container Service」セクションに移動します。
New Relic ECS インテグレーションをインストールしたクラスタをクリックします。
Services
タブで、フィルターを使用してインテグレーション サービスを検索します。 自動インストール スクリプトを使用した場合、サービスの名前は
newrelic-infraになります。 Fargate を使用している場合は、モニター サービスの名前になります。 見つかったら、名前をクリックします。サービス ページには、サービスの
Status
が表示されます。 サービスに問題がない場合、
ACTIVEと表示されます。同じページで、
Desired
カウントは
Running
カウントと一致する必要があります。 これは、サービスが処理しているタスクの数です。 デーモン サービス タイプを使用するため、クラスター内のコンテナー インスタンスごとに 1 つのタスクが存在する必要があります。 すべてのタスクが実行されているため、保留カウントはゼロになるはずです。
Events
タブを調べて、タスクのスケジュール設定または開始に関する問題がないか確認します。
サービスの
Tasks
タブで、
Task status
セレクターをクリックすると、実行中のタスクと停止したタスクを検査できます。
Stopped
ステータスを選択すると、起動に失敗したコンテナが表示されます。
タスクをクリックすると、タスクの詳細ページに移動します。
Stopped reason
の下に、タスクが停止された理由を説明するメッセージが表示されます。
タスクが実行されているにもかかわらずデータが表示されない場合は、 verbose log を生成し、エラーがないか調べてください。
停止したタスクの理由の詳細については、 停止したタスク を参照してください。
停止したタスクの理由
AWS ECS troubleshooting documentation には、実行中のタスクやサービスに関するエラーの一般的な原因に関する情報が掲載されています。タスクが停止するいくつかの理由については、以下を参照してください。
Task stopped with reason:
Fetching secret data from AWS Secrets Manager in region YOUR_AWS_REGION: secret arn:aws:secretsmanager:YOUR_AWS_REGION:YOUR_AWS_ACCOUNT:secret:YOUR_SECRET_NAME: AccessDeniedException: User: arn:aws:sts::YOUR_AWS_ACCOUNT:assumed-role/YOUR_ROLE_NAME is not authorized to perform: secretsmanager:GetSecretValue on resource: arn:aws:secretsmanager:YOUR_AWS_REGION:YOUR_AWS_ACCOUNT:secret:YOUR_SECRET_NAME status code: 400, request id: 9cf1881e-14d7-4257-b4a8-be9b56e09e3c"これは、タスク定義でexecutionRoleArnを使用して指定された IAM ロールが、 NRIA_LICENSE_KEYに使用されるシークレットにアクセスできないことを意味します。実行ロールには、シークレットを読み取るためのアクセス権を付与するポリシーがアタッチされている必要があります。
タスクの実行ロールを取得します。
bash$aws ecs describe-task-definition --task-definition newrelic-infra --output text --query taskDefinition.executionRoleArn--task-definition newrelic-infraを、サイドカー コンテナーを含む fargate タスクの名前に置き換えることができます。bash$aws ecs describe-task-definition --task-definition YOUR_FARGATE_TASK_NAME --output text --query taskDefinition.executionRoleArnロールに付随するポリシーを一覧表示します。
bash$aws iam list-attached-role-policies --role-name YOUR_EXECUTION_ROLE_NAMEこれにより、3 つのポリシー
AmazonECSTaskExecutionRolePolicy、AmazonEC2ContainerServiceforEC2Role、およびへの読み取りアクセスを許可する 3 番目のポリシーが返されます。 次の例では、ポリシーの名前はNewRelicLicenseKeySecretReadAccessです。{"AttachedPolicies": [{"PolicyName": "AmazonECSTaskExecutionRolePolicy","PolicyArn": "arn:aws:iam::aws:policy/service-role/AmazonECSTaskExecutionRolePolicy"},{"PolicyName": "AmazonEC2ContainerServiceforEC2Role","PolicyArn": "arn:aws:iam::aws:policy/service-role/AmazonEC2ContainerServiceforEC2Role"},{"PolicyName": "YOUR_POLICY_NAME","PolicyArn": "arn:aws:iam::YOUR_AWS_ACCOUNT:policy/YOUR_POLICY_NAME"}]}デフォルトのポリシーバージョンを取得します。
bash$aws iam get-policy-version --policy-arn arn:aws:iam::YOUR_AWS_ACCOUNT:policy/YOUR_POLICY_NAME --version-id $(aws iam get-policy --policy-arn arn:aws:iam::YOUR_AWS_ACCOUNT:policy/YOUR_POLICY_NAME --output text --query Policy.DefaultVersionId)これにより、ポリシーの権限が取得されます。 AWS Secrets Manager を使用して を保存した場合は Action
secretsmanager:GetSecretValueのエントリがあり、 AWS Systems Manager の メンバ Store を使用した場合はssm:GetParametersのエントリがあるはずです。