AWS Lambda関数NewRelic-log-ingestion-s3
を使用して、AmazonS3バケットをNewRelicに送信できます。これは、AWSサーバーレスアプリケーションリポジトリから簡単にデプロイできます。
S3バケットからNew Relicにログを転送することで、ログデータの収集、処理、探索、問い合わせ、アラートなどのログ管理機能が強化されます。
ラムダ関数のインストール
S3のログをNew Relicに転送するLambda関数をインストールすること。
あなたが持っていることを確認してください
.
AWS Serverless Application Repository をブラウザで開きます。
Lambda が S3 バケットと同じリージョンにインストールされていることを確認してください。
newrelic
を検索し、 [カスタムIAMロールまたはリソースポリシーを作成するアプリを表示する]をオンにして、NewRelic-log-ingestion-s3
を見つけます。NewRelic-log-ingestion-s3
の詳細をクリックし、[デプロイ]をクリックします。アプリケーション設定 までスクロールし、New Relic を入力します
.
Lambda関数の環境変数として
logtype
を指定することで、NewRelicのログ解析機能を利用できます。詳細については、 組み込みの解析ルールセットを参照してください。アプリがカスタムIAMロールを作成することを確認して、「 Deploy」をクリックします。
関数がデプロイされたら、 Lambdaトリガーを作成します.
Serverless Frameworkを使った手動インストール
Serverless Frameworkを使って、ターミナルから手動でLambdaをインストールし、設定することができます。Linuxでない場合は、 Docker を最初にインストールして、それを実行しておいてください。
$# Clone the repository$git clone https://github.com/newrelic/aws_s3_log_ingestion_lambda.git$# Install <a href="https://www.npmjs.com/package/serverless">Serverless</a> and the repo dependencies$npm install -g serverless$npm install$# Set the New Relic License Key env variable$export LICENSE_KEY=YOUR_NEWRELIC_LICENSE_KEY$# Set the logtype (optional)$export LOG_TYPE=YOUR_LOGTYPE$# Set the S3 bucket name$export S3_BUCKET_NAME=YOUR_S3_BUCKET_NAME$# The S3 subdirectory (optional)$export S3_PREFIX=YOUR_S3_SUBDIRECTORY$# Choose a name for your new Serverless Framework service$export SERVICE_NAME=YOUR_SERVICE_NAME$# Deploy the function, specifying the same region as your S3 bucket listed above$serverless deploy --region YOUR_AWS_REGION
AWSでのLambdaトリガーの作成
ログをNew Relicにストリーミングするには、Lambdaにトリガーを取り付けます。
- 左側のメニューで「 Functions 」をクリックします。
- 以前に作成した
NewRelic-s3-log-ingestion
関数を見つけて選択します。 - Designer の下で、 Add Triggers をクリックし、ドロップダウンから S3 を選択します。
- New Relicに送信したいログが入っているS3バケットを選択します。
- オプションで、 プレフィックスとサフィックス を設定します。これは、ログがサブディレクトリにある場合に便利です。
- Enable trigger のチェックボックスにチェックを入れ、 Add trigger を追加します。
Lambda関数をテストするには、関数の設定で設定したS3バケットに新しいログファイルをアップロードし、 ログデータを見る 。
このドキュメントはインストールで役立ちましたか。
制限
- サポートされているログファイルの最大サイズは、非圧縮で35MBです。
- サポートされている個々のログラインの最大サイズは0.25MBです。
- 暗号化されたログファイルには対応していません。
ログデータを表示する
すべてが正しく構成され、データが収集されている場合は、次の両方の場所にログ データが表示されるはずです。
例えば、次のようなクエリを実行することができます。
SELECT * FROM Log
トラブルシューティング
ログフォワーダーの構成で問題が発生した場合は、次のトラブルシューティングのヒントを試してください。
次は何ですか?
- ログインコンテキスト機能を使用してログを転送することにより、アプリケーションとプラットフォームのパフォーマンスデータの両方をより深く把握できます。
- アラートを設定します。
- データをクエリし、ダッシュボードを作成します。
ログ転送を無効にする
ログ転送機能を無効にするには、 Amazon S3 のドキュメント に記載されている標準的な手順に従ってください。New Relicでは他に何もする必要はありません。