OpenTelemetryを使用したアプリケーションの監視 (2025/02/08)

OpenTelemetryを使用したアプリケーションの監視 (2025/02/08)

https://blogs.oracle.com/observability/post/application-monitoring-with-opentelemetry

投稿者： Zyaad Khader | Principal Member of Technical Staff

Anand Prabhu | Senior Member of Technical Staff


多くの場合、スタック・コンポーネントで変化するアプリケーションの監視は困難です。これらのコンポーネントを監視するための統合的なアプローチにより、発生する可能性のある問題をエンドツーエンドで可視化し、インサイトを得ることができます。OpenTelemetryは、ほとんどのプログラミング言語のトレース、メトリックおよびログ・データを収集するための業界標準です。OCI Application Performance MonitoringやOCI Logging AnalyticsなどのOCI Observability and Managementサービスと組み合わせることで、強力なインサイトを提供できます。この記事では、OpenTelemetryを使用してアプリケーションを監視する方法について説明します。



アプリケーション・データを収集するためのOpenTelemetry標準


OpenTelemetryは、トレース、メトリックおよびログをモニタリング・ツールに送信するためのオープンソース・フレームワークです。プログラミング言語ごとに様々な実装があり、常に更新/開発されています。このフレームワークを使用する目的は、監視データを収集および送信するための統一された標準化された方法を持つことです。このブログでは、OpenTelemetryを使用してアプリケーションをインストゥルメントし、収集されたデータをApplication Performance MonitoringやLogging AnalyticsなどのOCIサービスにエクスポートする方法について説明します。


図1:  OpenTelemetryデータ・フロー図



一貫したサービス・レベルを診断および提供するためのOCI Application Performance Monitoring


Application Performance Monitoring (APM)は、アプリケーションのパフォーマンスを詳細に可視化し、問題を迅速に診断して一貫性のあるレベルのサービスを提供する機能を提供します。これには、クライアント、サードパーティ・サービスおよびバックエンド・コンピューティング層(オンプレミスまたはクラウド)に分散した複数のコンポーネントおよびアプリケーション・ロジックの監視が含まれます。


図2: Application Performance Monitoringのデータ・フロー図



ログ・データに関する重要なインサイトを得るためのOCI Logging Analytics


Logging Analyticsは、Oracle Cloud Infrastructureのクラウド・ソリューションで、アプリケーションおよびシステム・インフラストラクチャからのすべてのログ・データのインデックス作成、エンリッチ、集計、探索、検索、分析、相関、可視化、および監視を行うことができます。Logging Analytics内に構築された厳選されたAI/MLモデルを使用して、ログ・データから強力なインサイトを得ることができます。


図3: Logging Analytics機能の図



GitHubの例


MERN/MEAN/MEVNアプリケーションの監視を実装する場合は、次のGitHubリポジトリを使用します。


https://github.com/oracle-quickstart/oci-observability-and-management/tree/master/oci-opentelemetry-solution


このリポジトリには次のものが含まれます。


  • アプリケーションのフロントエンドおよびバックエンドをインストゥルメントするファイル
  • APMにカスタム・メトリックを送信するファイル
  • Logging Analyticsにログ・メッセージを送信するファイル
  • OpenTelemetry実装を試すサンプル・アプリケーション


サンプル・ユース・ケース


GitHubの例のトレース・スクリプト、メトリック・スクリプトおよびロギング・スクリプトを使用して、ユーザー管理Webアプリケーション(MERNスタック上に構築)を監視しました。目標は、トレース・データとビジネス、ユーザー・エクスペリエンス、カスタム・ホスト・メトリックで構成されるダッシュボードを作成することでした。


図3: OCIのMERNアプリケーション・ダッシュボード



Getting started


OpenTelemetry実装は、様々なプログラミング言語のメトリック、トレースおよびログに対して安定した、実験的な、またはまだ開発されていない可能性があることを認識することが重要です。下にスタックの互換性を表示:


ステータスおよびリリース


APMドメインの作成


OCIドキュメントを確認してAPMドメインを作成します


  • 「APM管理」ページに移動します(メインの「OCI」メニュー→監視および管理→アプリケーション・パフォーマンス管理→管理)
  • 「APMドメインの作成」をクリックし、ドメイン名を指定します。
  • 次の点に注意してください(APMドメイン・ページで確認)。
    • データ・アップロード・エンドポイント(APMにデータを送信するためのURL)
    • 公開データ・キー(APMブラウザ・エージェントで使用)
    • プライベート・データ・キー(OpenTelemetryなどのデータ・コレクタに接続する場合)


API署名キーの作成


  • OCIコンソールにログイン → ユーザー → ユーザー設定
  • 「リソース」でAPIキーを選択します
  • 「APIキーの追加」→「APIキー・ペアの生成」→「秘密キーのダウンロード」→「追加」をクリックします。
  • 構成ファイルのプレビューおよびクローズからコンテンツをコピーします


構成ファイルの作成


ディレクトリ(.oci)と、構成ファイルのプレビューおよび秘密キー・ファイルへのパスからのコンテンツを含む構成ファイルを作成します。次に、構成ファイルの内容の例を示します。


[DEFAULT]
user= [User OCID]
fingerprint= [API Key Fingerprint]
tenancy= [Tenancy OCID]
region= [Region]
key_file= [Path to Private Key File]


ログ・パーサーの作成


  • 監視と管理 → ログ分析 → 管理
  • 「パーサー」→「パーサーの作成」→「JSONタイプの選択」をクリックします。
  • フィールドを解析および抽出し、必要に応じて特定のフィールド名にマップするJSONログ・コンテンツの例を入力し、「変更の保存」をクリックします。


図4: ログ・レコードの例



ログ・ソースの作成


  • 「Logging Analytics」→「管理」→「ソース」→「ソースの作成」に移動
  • ソース・タイプ → ファイル
  • エンティティ・タイプ → ホスト(Linux)
  • 「特定のパーサー」を選択し、作成したパーサーを選択します。
  • 「ソースの作成」をクリックします。


図5: ログ・ソースの作成



ログ・グループの作成


  • 「Logging Analytics」 → 「管理」 → 「ログ・グループ」 → 「ログ・グループの作成」
  • ログ・グループ名と説明を指定 → 「作成」をクリックします。
  • 後で使用されるログ・グループのOCIDをノートにとります。



ネームスペースの詳細の取得


  • 「アイデンティティ」 → 「コンパートメント」 → ログ・ソースが作成されたコンパートメントをクリック → コンパートメントのOCIDのコピー
  • 次に、クラウド・シェルを起動し、次のコマンドを実行して、次に示すコマンドを実行したネームスペースを取得します。


oci os ns get -c compartmentID


実装


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


アプリケーションのフロントエンドを監視するには、APMブラウザ・エージェントをインストゥルメントします。ステップはこちらから:



サーバーのインストゥルメンテーション:


  • エンドツーエンドのトレースを取得するには、ブラウザ/クライアントのフロントエンド・トレースからサーバーへのコンテキストの伝播が必要です。その際の注意点の1つは、コンテキストを提供するHTTPヘッダーがあることを確認することです。デフォルトでは、OpenTelemetryはW3C (トレース)を使用してコンテキストを自動的に伝播します。他のヘッダー・タイプも使用できますが、アプリケーション・コードを考慮する必要があります。
  • ブラウザ/クライアント・インストゥルメンテーションを実行するJavaScriptのスニペットを使用して、次のコードを必ず追加してください。



図6:  トレース・コンテキストの伝播図



アプリケーション・ログの送信中


アプリケーションは、OpenTelemetry APIを使用してトレースおよびメトリックを収集し、それをOCI Application Performance Monitoring (APM)に送信するためにインストゥルメントされます。次に、トレース、メトリックおよびログを関連付けてアプリケーションを完全に可視化できるOCI Logging Analyticsにアプリケーション・ログを送信する方法を学習します。標準のロギング・ライブラリを使用してロギングを有効にでき、次に示すように、OCI提供のSDKまたはRESTエンドポイントを使用してログを送信するようにカスタム・ログ・アペンダを構築する必要があります


図7:  ログ・データ・フロー図



ログ・アペンダの作成


カスタム・ログ・アペンダは、Java、Python、.Net、TypeScript/JavaScript、Go、Rubyなどの様々なプログラミング言語用に提供されているOCI Logging Analytics SDKを使用して構築することも、OCI Restエンドポイントを使用することもできます。


SDK

https://docs.oracle.com/en-us/iaas/Content/API/Concepts/sdks.htm


エンドポイント

https://docs.oracle.com/en-us/iaas/api/#/en/logan-api-spec/20200601/Upload/UploadLogFile



前述のステップから、ログを初期化してOCIログ・アナリティクスに送信するために必要なパラメータを収集します。


  1. [PATH]/config - 設定ファイルへのパス
  2. [PROFILE] - OCI認証に使用される構成ファイル内のプロファイル
  3. [名前空間] - ネームスペース
  4. [UPLOADNAME] - アップロードのユーザー定義名
  5. [LOGSOURCENAME] - OCIロギング分析で作成されたログ・ソース名
  6. [LOGFILENAME] - ログ・メッセージが特定のログ・ファイルに関連していることを示すログ・ファイル名
  7. [LOGGROUPID] - ログ・メッセージをグループ化するためにロギング分析で作成されたログ・グループID


GitHubの例: ログ・アペンダ – JavaScript (MERNスタック)


ログ・アペンダにより、ログ・レコードが様々なログ・レベル(デバッグ、情報、警告およびエラー)に対して作成されると、OCI Logging Analyticsに送信され、次に示すようにログ・エクスプローラでログ・レコードを表示できます。


図8: ログ・エクスプローラ・ビュー



トレースとログの関連付け


OpenTelemetryでは、ログ・レコードにTraceIdおよびSpanIdが含まれ、これにより、同じ実行コンテキストに対応するログおよびトレースを直接関連付けることができます。アプリケーション・トレースおよびスパンがOCI Application Performance Monitoringに流れ、OCI Logging Analyticsサービスにログインします。OCI APMでは、ドリルダウン構成を使用して、トレースやスパンからログイン分析にワンクリックで簡単に移動できます。


ドリルダウンは、スパンからの属性(例: loganalytics/explorer?search=<OciInstanceId> OciInstanceIdはスパン属性)を含むカスタマイズ可能なURLを使用する、OCIまたはその他のカスタム・サービス内の他のサービスへのリンクです。


トレースおよびログをリンクするドリルダウンを作成するステップ:


図9:  トレースおよびログのカスタム相関の作成



カスタム・ダッシュボードの作成


データとメトリックをOCIでトレースしたら、そのデータを使用して、任意の方法で視覚的に表現します。カスタム・ダッシュボードの作成は簡単です。必要なウィジェットをドラッグ・アンド・ドロップし、ソース・データ(メトリック、トレースまたはログ・データ)を変更します。ダッシュボードを開始するためのいくつかのリンクを次に示します:




リソース

コメント

コメントを投稿

このブログの人気の投稿

Oracle Database 19cサポート・タイムラインの重要な更新 (2024/11/20)

イメージ
Oracle Database 19cサポート・タイムラインの重要な更新 (2024/11/20) https://mikedietrichde.com/2024/11/20/important-update-to-oracle-database-19c-support-timelines/ 長い沈黙は、私が隠れているという意味ではありません。つまり、今はとても忙しいということです。そして、より少ない旅行で、私はあなたのコメントにもブログと返信するより多くの時間を持っていることを願っています。それでも、Oracle Database 19cサポート・タイムラインの非常に重要な更新について説明します。 * 更新された内容 2024年11月19日現在、Oracle Database 19cのサポート・タイムラインが調整されています。 MOSノート: 742060.1 – 現在のデータベース・リリースのリリース・スケジュールを見ると、新しい日付が表示されます。 Premier Support、2029年12月31日まで 2030年1月1日から2032年12月31日までの拡張サポート 2033年1月1日から2034年12月31日までのアップグレード・サポート これは知ることがとても大切です。 他のリリースの更新はありますか。 MOSノートの終わりにある変更ログ: 742060.1 – 現在のデータベース・リリースのリリース・スケジュールでは、Oracle Database 21cの最新の更新も確認できます。このリリースのPremier Support期間は、2027年7月31日まで延長されました。 また、Oracle Database 23aiのパッチ適用終了日は2032年12月31日に設定されています。 Lifetime Support Policy 更新は、Oracle Technology Productsの Oracle Lifetime Support Policy (6ページ)でも確認できます。 From: Oracle Lifetime Support Policy for Oracle Technology Product s – page 6 – Nov 19, 2024 特に、次の表に示す制限事項に注意してください。 Oracle Database 1...
続きを読む

Oracle GoldenGate 23aiでMicrosoft Fabricでのオープン・ミラーリングがサポートされるようになりました (2024/11/19)

イメージ
Oracle GoldenGate 23aiでMicrosoft Fabricでのオープン・ミラーリングがサポートされるようになりました (2024/11/19) https://blogs.oracle.com/dataintegration/post/how-to-replicate-to-mirrored-database-in-microsoft-fabric-using-goldengate 投稿者： Shrinidhi Kulkarni | Principal Product Manager Oracle GoldenGate 23aiでは、オープン・ミラーリングを介したMicrosoft Fabricへの統合のパブリック・プレビューがサポートされるようになりました。この強力な組み合わせにより、リアルタイムのデータ統合が可能になり、ハイブリッド環境とマルチクラウド環境のデータをMicrosoft Fabricのミラー化されたデータベースに継続的に同期できるため、データは常にAIと分析に対応できます。 Microsoft Fabric統合のOpen Mirroring は、GoldenGate for Distributed Applications and Analytics 23ai (GG for DAA) (23.6)製品を介して提供されます。 既存の Azure統合の詳細については、 ドキュメント を参照してください。 オープン・ミラーリングは、オープン・デルタ・レイク表形式に基づいて、データISVがMicrosoft Fabricのミラーリングを拡張できるように設計されています。この機能により、Oracle GoldenGate 23aiは、オープン・ミラー化パブリックAPIおよびアプローチに基づいて、Microsoft Fabricのミラー化データベースに変更データを直接書き込むことができます。Microsoft FabricでのOpen Mirroringの詳細については、「 Microsoft FabricでのOpen Mirroringの概要 」を参照してください。 このブログ投稿では、この統合の実装の側面について深く掘り下げ、GoldenGate統合の構成方法を示します。 構成ステップ: リファレンス・アーキテクチャの理解 前提条件 ...
続きを読む

Oracle APEXのInteractive Gridで、Oracle Formsと比較して、重複行の検証を制御/通過させる方法 (2022/07/21)

イメージ
Oracle APEXのInteractive Gridで、Oracle Formsと比較して、重複行の検証を制御/通過させる方法 (2022/07/21) https://medium.com/oracledevs/how-to-control-or-pass-validation-for-duplicate-rows-in-interactive-grid-of-oracle-apex-as-compare-18f453f750bf 投稿者： Jignesh oracle Formsでは、データブロックの重複行を制御するのは非常に簡単ですが、IGの検証を制御するにはどうすればよいでしょうか。 必要な出力 ステップ1：インタラクティブグリッドのある白紙ページを作成します（私は1つの領域「IG」を作成し、インタラクティブグリッドとしてタイプを選択しました） ステップ 2: リージョンに Static ID を定義する (私の場合、リージョンは IG で、Static ID も IG です) ステップ3：複製を制御したいカラムのStatic IDを定義します ステップ4：関数とグローバル変数に移動します コード： var validity, message, ui = this.data; (function($) { function update(model) { var projKey = model.getFieldKey(“PROJECT_ID”), recObj = [], recArray = []; model.forEach(function(record, index, id) { var projid = parseInt(record[projKey], 10), // record[salKey] should be a little faster than using model.getValue in a loop meta = model.getRecordMetadata(id); if (!isNaN(projid) && !meta.deleted && !meta.agg) { recObj = {ID: id, project_id: projid}; recArray.push(recObj)...
続きを読む