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. Developer PortalでアプリのEnvironmentページに移動します。

2. New Relicで監視する環境の Details をクリックします。

3. Detailsタブに切り替えます。

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

   変数	説明
   NEW_RELIC_LICENSE_KEY	New Relicアカウントキー。
   NEW_RELIC_LOGS_URI	New RelicのログAPIのURI。詳細については、New Relic Regionsを参照してください。有効な値については、ログAPIを使用してログデータを送信するを参照してください。例：https://log-api.eu.newrelic.com/log/v1（EU）、https://log-api.jp.nr-data.net/log/v1（日本）
   NEW_RELIC_METRICS_URI	New RelicのメトリクスAPIのURI。詳細については、New Relic Regionsを参照してください。有効な値については、メトリクスAPIを介してメトリクスを報告するを参照してください。例：https://metric-api.eu.newrelic.com/metric/v1（EU）、https://metric-api.jp.nr-data.net/metric/v1（日本）。
   NEW_RELIC_APP_NAME (オプション)	New Relic の APM とサービス ページに表示される Mendix アプリケーション名。 デフォルト: ドメイン ホスト名。
   LOGS_REDACTION (オプション)	電子メール アドレスは、ログエントリが New Relic に送信される前に自動的に編集されます。 この秘匿化を無効にするには、 LOGS_REDACTIONをfalseに設定します。 デフォルト: true 。

5. アプリのEnvironmentsページに戻り、アプリを選択した環境にDeployまたはTransport入れます。

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``): これにより、特定の環境から送信されたメトリックを識別し、本番メトリックとテストメトリックを区別することができます。