Mendix クラウド統合

Mendix Cloud 統合は、Mendix Cloud 環境からインベントリとメトリクスを収集して New Relic に送信するため、その健全性とパフォーマンスを監視できます。

統合をインストールし、収集するデータを確認するために読んでください。

セットアップ

New Relic を利用するには、New Relic API キーが必要です。 アプリの既存のキーを検索するか、新しいキーをリクエストするには、次の手順に従います。

1. New Relic のアカウントにログインします。
2. 左下隅にある自分の名前をクリックして、ユーザー メニュー オプションを開きます。 次に、「API キー」をクリックします。
3. 既存の API キーをコピーするか、新しい API キーを作成します。 この目的のために、New Relic はLicenseタイプを推奨します。

ノードを New Relic に接続する

ランタイム情報を New Relic に送信するには、New Relic API キーを環境に提供する必要があります。

1. 開発者ポータルでアプリの「環境」ページに移動します。

2. New Relic で監視したい環境の [詳細] をクリックします。

3. 「ランタイム」タブに切り替えます。

4. 次のカスタム環境変数を追加します。

   変数	説明
   NEW_RELIC_LICENSE_KEY	New Relic のライセンス キーまたは API キー。 「New Relic API キー」セクション で取得します。
   NEW_RELIC_LOGS_URI	New Relic のログ API の URI。 詳細については、 New Relic リージョン を 参照してください。 例: https://log-api.eu.newrelic.com/log/v1 。
   NEW_RELIC_METRICS_URI	New Relic のメトリクス API の URI。 詳細については、 New Relic リージョン を 参照してください。 例: https://metric-api.eu.newrelic.com/metric/v1 。
   NEW_RELIC_APP_NAME (オプション)	New Relic の APM とサービスに表示される Mendix アプリケーション名。 デフォルト: ドメインのホスト名。
   LOGS_REDACTION (オプション)	電子メール アドレスは、ログエントリが New Relic に送信される前に自動的に編集されます。 この秘匿化を無効にするには、 LOGS_REDACTION を false に設定します。 デフォルト: true 。

5. アプリの「環境」ページに戻り、選択した環境にアプリをデプロイまたはトランスポートします。

New Relic のメトリクスのタグ付け

「APM ツールを使用した Mendix アプリのモニタリング」の「アプリ メトリクス」セクションで説明されているように、アプリ メトリクスの分析を支援するために、Mendix は New Relic の使用時にマイクロフローとアクティビティからのメトリクスにタグを追加します。

ランタイム アプリケーション ログに加えて、次の JSON 形式のメタデータが New Relic に自動的に送信されます。

• environment_id – 環境の一意の識別子
• instance_index – アプリケーションインスタンスの番号
• hostname – アプリケーションホストの名前
• application_name – ドメイン名から取得されたデフォルトのアプリケーション名
• model_version – Mendix ランタイムのモデル バージョン
• runtime_version – Mendix ランタイムのバージョン

これらのフィールドでデータをフィルタリングできます。

カスタムタグ

New Relic を使用して複数のアプリや環境を監視する場合、これらのメトリクスがどのアプリや環境に適用されるかを知ることができません。 New Relic でアプリと環境のメトリクスを特定するには、アプリ名と環境のタグを追加する必要があります。

Mendix では、次のタグの使用をお勧めします。

• app:{app_name} (例: app:customermanagement ) – これにより、アプリから送信されたすべての指標を識別できます
• env:{environment_name} (例: `env:accp`) – これにより、特定の環境から送信されたメトリクスを識別できるため、実稼働メトリクスをテストメトリクスから分離できます。

追加情報

NEW_RELIC_LOGS_URIとNEW_RELIC_METRICS_URIの有効な値は、New Relic ドキュメントの「Send Your Logging Data with Our Log API」および「 Introduction to the Metric API」にリストされています。