アプリケーションパラメーター

アプリケーションパラメーターはアプリケーションの重要なメトリクスを監視するのに役立つ機能です。アプリケーションパラメーターを用いて監視できるのは次のようなものがあります。

• 変数のサイズ、値、頻度
• アプリケーション操作のサイズや頻度

API要求、データベース操作、キャッシュヒットに関する簡単なWeb要求があったとします。単一の要求が複数のリソースを呼び出したり、複数のユーザーが複数の要求を一度に呼び出すことができます。これらの例では、APIが要求された頻度や特定の期間間隔で行われたデータベースの操作回数を把握できます。CPUやメモリがオーバーロードしているかを評価でき、選択した時間間隔でそれがどのようにアプリケーションパフォーマンスに影響しているのかも把握できます。

実際のアプリケーションでは、データベース要求、サービス要求、ユーザー定義のフレームワーク要求のヒット頻度を監視している場合に、アプリケーションパラメーター機能が便利です。アプリケーションパラメーターのレポートに基づいて、ヒットのオーバーロードで引き起こされたパフォーマンスの低下をトラブルシュートできます。

アプリケーションパラメーターの設定方法：

• 関係する操作
• .NETアプリケーションのインストール手順
• .NET Coreアプリケーションのインストール手順
• Javaアプリケーションのインストール手順
• Node.jsアプリケーションの手順
• アプリケーションパラメーターの表示

関係する操作：

1. 合計

• 特定の間隔でパスされたパラメーターの全ての値の合計です。

2.平均

• 特定の間隔でパスされたパラメーターの平均値です。

全てのパラメーターが次のメトリクスに送られて、頻度を追跡します。

合計：

1.パラメーター名：

• パラメーター名はアプリケーションのユーザーが入力します。

2.合計値：

• 特定の期間間隔で対応したパラメーターの集計値です。

平均：

1.パラメーター名：

• パラメーター名はアプリケーションのユーザーが入力します。

2.合計値：

• 特定の期間間隔で対応したパラメーターの集計値です。

3.最小値：

• 特定の期間で収集されたパラメーターの最小値です。

4.最大値：

• 特定の期間で収集されたパラメーターの最大値です。

5.合計数：

• ヒットの合計数です。

アプリケーションパラメーターAPIは.NETとJavaエージェントで利用可能です。設定手順は次を参照してください。

.NETアプリケーション：

1. APMインサイト.NETエージェントをインストールします。
2. インストールパスにあるDotNetAgent.Api.dllをアプリケーションを参照するために追加します。
3. コードスニペットを指定された場所に追加します。

合計：
パラメーターの特定の間隔でパスされた値の合計です。合計の値に何も入力していない場合は、合計が1ずつ増加します。

DotNetAgent.Api.CustomTracker.Increment("keyName");
DotNetAgent.Api.CustomTracker.Increment("keyName", value);

平均：
特定の間隔でパスされたパラメーターの平均値です。

DotNetAgent.Api.CustomTracker.Average("keyName", value);

例：

public ActionResult Register()

{

DateTime st = DateTime.Now;

double myKeyValue = Convert.ToDouble(Request.QueryString["mykey"]);

//parameter "register" will be incremented by 1 and sent as SUM

DotNetAgent.Api.CustomTracker.Increment("register");

//parameter "mykey" will be incremented by myKeyValue and sent as SUM

DotNetAgent.Api.CustomTracker.Increment("mykey", myKeyValue);

double myKeyAvgValue = GetAverageValue();

//parameter "myavgkey" will be incremented by value and sent as AVG

DotNetAgent.Api.CustomTracker.Average("myavgkey", myKeyAvgValue);

return View();

}

4. アプリケーションを公開し、パラメーターの追跡を開始します。

.NET Coreアプリケーション：

1. APM Insight .NET Coreエージェントをインストールします。
2. パッケージSite24x7.DotNetAgent.ApiをNuGetパッケージマネージャーからWebアプリケーションプロジェクトへ追加します。
3. 所定の位置に次のコードを追加します：
   合計：
   パラメーターの特定の間隔でパスされた値の合計です。合計の値に何も入力していない場合は、合計が1ずつ増加します。

   
   Site24x7.Agent.Api.Increment("keyName");
   Site24x7.Agent.Api.Increment("keyName", value);

   
   平均：
   特定の間隔でパスされたパラメーターの平均値です。

   
   Site24x7.Agent.Api.Average("keyName", value);

   
   例：
   
   public ActionResult Register()
   {
   DateTime st = DateTime.Now;
   double myKeyValue = Convert.ToDouble(Request.QueryString["mykey"]);
   
   //parameter "register" will be incremented by 1 and sent as SUM
   Site24x7.Agent.Api.Increment("register");
   
   //parameter "mykey" will be incremented by myKeyValue and sent as SUM
   Site24x7.Agent.Api.Increment("mykey", myKeyValue);
   
   double myKeyAvgValue = GetAverageValue();
   //parameter "myavgkey" will be incremented by value and sent as AVG
   Site24x7.Agent.Api.Average("myavgkey", myKeyAvgValue);

   
   return View();
   }

4. アプリケーションを公開し、パラメーターの追跡を開始します。

Javaアプリケーション：

1. APMインサイトJavaエージェントをインストールします。
2. 前提条件を確認します 。 アプリケーションビルドパス(apminsight-javaagent-api.jar)にあるAPI jarをバンドルします。 推奨している場所は WEB-INF/libです。
3. コードスニペットを指定の場所に追加してください。