4.5.x アプリケーション分析の注意事項

次の注意事項では、AppDynamics アプリケーション分析に対する更新について説明します。これにより、AppDynamics Business iQ が強化されます。

アーティファクトが更新されている場合は、バージョン番号とそのアベイラビリティの日付が次のように表示されます。バージョン番号は、AppDynamics ダウンロードポータルにも表示されます。

最新のリリースがページの上部に表示されます。

既知の問題 - Analytics エージェントのないトランザクション分析（エージェントレス分析）

Java エージェントバージョン 4.5.15 以降にアップグレードし、現在トランザクション分析を使用している場合、エージェントレス分析が自動的に有効になります。次の 2 つの既知の問題に関連して異常な動作が発生する場合があります。

• High CPU usage
• ブロックされたファイアウォール要求

これらの問題の詳細については、「分析の問題のトラブルシューティング」を参照してください。

4.5.13（SaaS イベントサービス）

ADQL クエリ用に eventcompletionTimestamp フィールドが導入されました。eventcompletionTimestamp は、イベントがイベントサービスによって受信された時刻を示します。詳細については、「Analytics Events API」を参照してください。  

メトリックプロセッサは、SaaS コントローラに段階的に導入されます。詳細については、AppDynamics サポートまでお問い合わせください。

4.5.17（コントローラ）の更新

2020 年 1 月 29 日

拡張機能

分析エージェントを使用しないトランザクション分析は、次のようになりました。

• 暗号化されたプロキシ接続と互換性を持つようになりました。Secure Credential Store を使用してプロキシの資格情報を暗号化すると、プロキシ設定が自動的にイベントサービスに接続されるようになりました。

• Java エージェント 4.5.15 以降を搭載した SaaS コントローラが自動的に有効化されるようになりました。

• Java エージェント 4.5.18 以降で設定されているライセンスルールがサポートされるようになりました。 

既知の問題

分析エージェントを使用しないトランザクション分析は、Java エージェント 4.5.16 以降を搭載した SaaS コントローラで自動的に有効になります。複数のノードに分析を展開する場合、トランザクション分析データを受信できないことがあります。AppDynamics では、複数のノードを実行している場合、Java エージェント 4.5.15 以降にアップグレードしないことを推奨しています。展開をすでにアップグレードしている場合は、AppDynamics サポートに連絡してダウングレードしてください。 

4.5.13（分析エージェント）の更新

2020 年 1 月 22 日

拡張機能

• 分析ライブラリが分析エージェントでアップグレードされ、分析エージェントがマシンエージェントにバンドルされました。「 マシンエージェントの注意事項」を参照してください。 

4.5.2 の更新（オンプレミスのイベントサービス）

2019 年 12 月 13 日

サポート終了通知（EoL）の注意事項

AppDynamics はオンプレミスのイベントサービスバージョン 4.5.2.20561 から検索ガードを削除しました。

詳細については、「サポートアドバイザリ」を参照してください。

4.5.16 の更新

2019 年 11 月 14 日

拡張機能

• 分析エージェントを使用しないトランザクション分析

  • 専用の分析エージェントを使用せずにトランザクション分析が設定できるようになりました。このモデルでは、アプリケーション エージェントは追加のエージェントを使用せずに分析データをイベントサービスに直接送信します。この機能は、Java エージェントバージョン 4.5.16 以降で使用できます。 

  • SaaS およびオンプレミス展開で使用できます。 
• 分析設定 UI がアップグレードされました。トランザクション分析とデータコレクタの設定は、現在は別のタブで行います。1 回のクリックですべてのアプリケーションとビジネストランザクションを選択できるようになりました。また、すべての着信アプリケーションのトランザクション分析を自動的に有効にすることもできます。  

4.5.15 の更新

2019 年 11 月 1 日

拡張機能

分析ランディングページにすべてのウィジェットのドリルダウンオプションが表示されるようになりました。任意のデータポイントをクリックして、ウィジェットを作成した ADQL クエリおよび検索結果を開くことができます。 

4.5.13 の更新

2019 年 8 月 26 日

拡張機能

• 分析に、トランザクション、ブラウザ、モバイルイベントの主なデータを統合するランディングページが表示されるようになりました。新しい分析のホームページに分析データの全体的なビューが表示されます。これにより、バックエンドのデータとエンドユーザーセッションが 1 つの画面で簡単に統合されます。

  

• 他のクエリで使用するために ADQL クエリの結果からテキストをコピーできるようになりました。 

4.5.12 の更新

2019 年 7 月 31 日

解決済みの問題

4.5.11 の更新

2019 年 7 月 8 日

解決済みの問題

4.5.9 の更新

バージョン 4.5.9.20968 – 2019 年 5 月 16 日

拡張機能

• 分析エージェントのセキュア クレデンシャル ストアの場所が <analytics_agent_home>/bin/tool/scs-tool.jar に変更されました。詳細については、「エージェントの認証情報を暗号化する」を参照してください。 

解決済みの問題

4.5.7 の更新

バージョン 4.5.7.20413 - 2019 年 3 月 18 日

拡張機能

• 分析エージェントのプロパティファイルで分析エージェントの機密テキストを暗号化できるようになりました。 

解決済みの問題

4.5.5 の更新

2019 年 2 月 25 日

解決済みの問題

4.5.4 の更新

バージョン 4.5.4.20153 – 2019 年 2 月 1 日

拡張機能

• 分析フィールド名で大文字と小文字が区別されるようになりました。  
• ADQL クエリで、LIMIT 句を使用して series 関数がすべての期間のグローバル上位 n を計算できるようになりました。以前のクエリは、各バケット関数の上位 n を計算していました。 

解決済みの問題

4.5.2 の更新

バージョン 4.5.2.19522 – 2018 年 12 月 21 日

この分析アーティファクトのビルドは、AppDynamics コントローラバージョン 4.5.4 で使用できる最新のものです。

解決済みの問題

バージョン 4.5.2.18474 – 2018 年 10 月 15 日

拡張機能

• ADQL が文字列操作関数を提供するようになりました。
  

  • 文字列関数は、Analytics イベントサービスに存在するすべてのイベントデータを変換できます。 

  • 重要な使用例の 1 つは、データが誤った構造、シリアル化、またはフォーマットで収集された場合にアドホックデータ変換を実行することです。以前のリリースでは、誤って収集されたデータを修正するには、エージェントの設定を調整する必要がありました。

  • 文字列操作関数を使用すると、次の操作が可能です

    • 文字列の length() 、文字列内の indexOf() 文字、またはこれらの両方を処理することで、substring() に焦点を合わせることができます

      • たとえば、URL からドメイン名を抽出できます

    • concat() 演算子を使用して複数の文字列を連結できます

      • たとえば、複数のフィールドの値を 1 つの値に結合することができます

    • trim()フィールドの先頭と末尾の空白。

• ビジネスジャーニーを作成する場合、そのビジネスジャーニーのすべてのマイルストーンのプライマリキーに同じデータタイプを使用する必要があります。
  

  • 以前は、サポートされていないさまざまなデータタイプを使用できました。

既知の問題

• ADQL 関数 indexOf() が構文の強調表示に失敗する。
• クエリが 2 つの distintcount() クエリの比率である場合、ADQL クエリからメトリックを作成できない

解決済みの問題

4.5.1 の更新

バージョン 4.5.1.18232 – 2018 年 9 月 5 日

拡張機能

• ログ分析で、定義されたソースルールからファイルを除外したり、ブラックリストに登録したりできるようになりました。除外するファイルの相対パスを入力します。ワイルドカードを使用すると、複数のファイルを除外します。

既知の問題

• Analytics バージョン 4.5 のリリースよりも前に作成されたビジネスジャーニー用のダッシュボードには、次のマイルストーンに到達するまでの平均時間メトリックが表示されません。回避策として次の手順を使用します。
  1. 編集用にビジネスジャーニーの定義を開く
  2. 編集するマイルストーンの Extract Fields 領域に移動する
  3. 次の 1 つまたは複数の操作を実行します。
     • プライマリキー以外のフィールドの定義を編集する
     • 新しいフィールドを作成する
     • 既存のフィールドを削除する
  4. 定義を保存する
     数分以内に、編集したビジネスジャーニーの次のマイルストーンに到達するまでの平均時間の値が表示されます。

解決済みの問題

4.5.0 の更新

2018 年 7 月 11 日

拡張機能

ADQL

• ADQL ユーザーエクスペリエンスの向上：
  • ADQL UI に新しい検索を保存するための Save ボタンが追加されました。
  • 次のフィールドが mobile_snapshots の ADQL UI に追加されました。Platform、 Request Content Length、 Response Content Length、 Country、 Region、 Background。
  • Analytics Search ページに、数値フィールドの標準偏差、中央値、最小値、最大値などの詳細な統計情報が表示されるようになりました。関連する統計情報を表示するには、フィールドをクリックします。
    
• ADQL に HAVING と SINCE ...UNTIL 句が含まれるようになりました。
• ADQL で totalResultCount() 関数がサポートされるようになりました。この関数はイベントの合計数を返します。totalResultCount() はフィールドを受け入れません。
  
• avg、max、min などの分析機能で、datetime タイプのデータがサポートされるようになりました。
• Business iQ / Analytics の外部使用で、大規模なデータセットと引用符で囲まれたフィールドを CSV 形式のファイルにエクスポートできるようになりました。
• IS NOT NULL 演算子が、Funnel フィルタなどの基本モード（ドラッグアンドドロップ検索）でサポートされるようになりました。この演算子は、すべてのイベントを true または false のいずれかの値で返します。

ウィジェット

• 数値ウィジェットに比較インジケータが表示されるようになりました。ウィジェットプロパティの Compare to および Trailing By オプションを使用してオフセットを示します。デフォルトでは、Compare to オプションは None に設定されています。Compare to ドロップダウンから Prev.period を選択し、Trailing By オプションを使用して分、時、または日単位で相対時間を指定します。現在の集約値は指定した期間と比較され、その差がウィジェットに表示されます。
• すべてのウィジェットのパーセンタイル集約でユーザー入力がサポートされるようになりました。サポートされる値は 1 ～ 99 の範囲の整数です。基本モードでは、数値フィールドをキャンバスにドラッグし、フィールド名の横にあるドロップダウンを使用して、パーセンタイル集約の値を指定します。
• 対数目盛が時系列グラフの分析ウィジェットでサポートされるようになりました。ウィジェットプロパティの Logarithmic Y Axis  チェックボックスを使用し、選択したフィールドに対数目盛を適用します。
• 複数のウィジェットのプロパティを編集できるようになりました。
• 凡例を非表示にする機能がウィジェットでサポートされるようになりました。ウィジェットプロパティで、Legend ドロップダウンから None を選択し、凡例を非表示にします。
• 分析ウィジェットのプロパティにウィジェットの背景を透明にするオプションが追加されました。
• Funnel ウィジェットに手順を並べ替えるオプションが追加されました。
• エージェント ID とクライアント GUID が Data タブに表示され、カスタムウィジェットを作成するために使用できます。
• Close Widget Builderこのオプションでは、ウィジェット編集をキャンセルできるようになりました。このオプションを使用すると、編集中にウィジェットへの不要な変更をドロップし、ウィジェットを閉じることによって以前のバージョンに戻すことができます。
• ヒストグラムの余分な空白が削除されました。ヒストグラムがダッシュボードで縮小表示されるようになりました。
• 数値ウィジェットを使用して作成されたメトリックで、検索で返される正確な値が表示されるようになりました。Widget Properties で、Formatドロップダウンから Exact を選択すると、正確な番号が表示されます。使用可能なその他のオプションは、Automatic、Thousands(k)、および Millions(m) です。デフォルトは Millions(m).

ビジネスジャーニー

• ビジネスジャーニー作成は次の機能によって強化されています。
  • ビジネス成果はビジネスジャーニーという名前に変更されました。
  • ビジネスジャーニーページに、基本イベントにワンクリックでアクセスできる Search ボタンが表示されるようになりました。有効なビジネスジャーニーを選択し、Analytics Search をクリックすると、基本モードの Searches ページに直接移動できます。Analytics Search ボタンは、Draft 状態および Valid Draft 状態の定義では使用できません。
  • 浮動タイプが、ビジネスジャーニーイベントのフィルタリングをサポートするようになりました。
  • カスタムイベントデータを使用して、ビジネスジャーニーを作成できます。
  • フィルタの一部であるすべてのフィールドとオプションのフィルタは自動的に収集されます。
  • ビジネスジャーニーを定義する場合、同じフィールドを 1 つのマイルストーンから削除し、同じ保存操作で別のマイルストーンに追加できるようになりました。
  • ブール値を使用してワークフローのステータスを追跡できる completed という名前のフィールドがビジネスジャーニーレベルに追加されました。True はビジネスジャーニーが完了したことを表し、一方 False は、ビジネスジャーニーが進行中であるか、または完了していないことを示します。クエリ文字列 completed, を含む任意のビジネスジャーニーで検索ウィジェットまたは ADQL クエリを使用して、関連するイベントのステータスを表示します。

  • Analytics のビジネスジャーニーページに、ビジネスジャーニーに関連付けられたビジネスワークフローを詳述したフローマップが表示されるようになりました。ビジネスジャーニーのマイルストーンを作成すると、フローマップが自動的に表示されます。さらに、ビジネスジャーニーを選択すると、フローマップが有効になっている新しいウィンドウでそのビジネスジャーニーが開きます。

  • Analytics により、ビジネスジャーニーの定義レベルとマイルストーンレベルで、設定済みのメトリックが生成されます。メトリックブラウザでこれらのメトリックを表示します。 

  • Analytics には、ビジネス ジャーニー ダッシュボード用の 2 つのビュー（カードビューとグリッドビュー）があります。

ビジネス指標

• Metrics ページのツールバーに Enable と Disable ボタンが表示されるようになりました。
•  Metrics ページに Event Type 列が追加されました。
• ビジネスメトリックをダブルクリックすると、メトリックブラウザでそのメトリックが開きます。
• ビジネスメトリックリストが検索可能になりました。
• 比率のメトリックがサポートされています。

エクスペリエンスレベルの管理（XLM）

• 次の方法で、XLM データの可視性が向上します。
  • 選択したタイムゾーンで XLM レポートを作成できるようになりました。
  • レポートをエクスポートできるようになりました。レポートは CSV 形式でエクスポートされ、選択したレポート期間がすべて含まれます。

• ある環境から別の環境に XLM 設定を移行できるようになりました。ステージング環境またはテスト環境で初めて設定を展開した後、実稼働に移行する必要がある場合などが、一般的な使用例です。

  このためには、2 つの API コールを実行します。

  1. 1 つの環境から XLM 設定をエクスポートします。

     GET /controller/analytics/xlm/configuration

     必要に応じて、クエリパラメータとして設定 ID または設定 ID のカンマ区切りリストを指定します。

     このパラメータを省略すると、API はすべての XLM 設定の一括エクスポートを返します。

  2. 1 つの XLM 設定を別の環境にインポートします。

     POST /controller/analytics/xlm/configuration

• 監査証跡に完全な XLM 設定情報が含まれるようになりました。監査証跡では、次の 4 つのフィールドが新しくなりました。

• XLM Configuration > Properties から：
• Event Type（監査証跡では Data Source と表示）

• XLM Configuration > Compliance Target Settings から：
• Compliance Target（監査証跡では Field と表示）
•  Start Date
•  Compliance Period

• 監査証跡を CSV ファイルにエクスポートできるようになりました。

ログ分析

ブラックリストへのファイルパスの glob パターンを定義することで、取り込みから除外するファイルを指定できるようになりました。
ここでは一般的な 2 段階の使用例を示します。

1. 取り込むすべてのファイルが含まれるように glob パターンを定義します
2. 最初の glob パターンを満たすが、取り込まないファイルを除外（ブラックリストに登録）するには、追加の glob パターンを定義します

アップグレードに関する注意事項

分析エージェントのアップグレード

分析エージェントをスタンドアロンバイナリとして実行している場合は、トピック「Analytics エージェントのアップグレード」を参照してください。

スタンドアロン マシン エージェントを介して Analytics エージェントを実行している場合は、「マシンエージェントのアップグレード」の手順を参照してください。 

ログ分析データを収集している場合は、次のようにします。

1. 新しい <analytics-agent-home> ディレクトリ構造で対応する場所にコピーできるように、古いウォーターマークファイルを保持します。
2. 新しい <analytics-agent-home> ディレクトリ構造で対応する場所にコピーできるように、既存のジョブファイルを保持します。

JAVA_HOME システム変数が設定されていない場合、手動でアップグレードされた環境ではイベントサービスが予期したとおりに機能しません。

Enterprise Console が JAVA_HOME システム変数の設定を処理するため、この問題はイベントサービスの新規インストールには影響しません。

データコレクタのフィールド名

4.3 より前のバージョンでは、データコレクタによって収集されたフィールドを表示するために、分析に実際の HTTP パラメータ名が使用されていました。4.3 以降、分析では、このようなフィールドに設定された表示名が使用されています。

エージェントバージョン 4.3 以降にアップグレードすると、新しい HTTP パラメータデータが表示名の下に表示されます。実際のパラメータ名と異なる表示名を設定している場合、1 つの HTTP パラメータについて、4.3 または 4.4 エージェントによって収集された履歴データと新しいデータが 2 つのフィールド名の間で分割されます。

トランザクション分析の有効化

4.3 エージェント以降では、分析設定 UI を使用してトランザクション分析を排他的に有効にする必要があります。分析設定 UI では、アプリケーションレベルで分析を有効にすることができます。廃止された analytics-dynamic-service-enabled ノードのプロパティは使用しないでください。 

エージェント設定 UI を使用して analytics-dynamic-service-enabled ノードプロパティを変更した場合は（analytics-dynamic-service-enabled ノードプロパティを直接更新）、バージョン 4.3 以降の Java エージェントには影響しません。

関連する背景

バージョン 4.2 以前のアプリケーション サーバー エージェントは、analytics-dynamic-service-enabled ノードプロパティを使用してトランザクション分析を有効にします。ノードアプリケーションを使用して、アプリケーション、ティア、およびノードレベルで Analytics Dynamic Service を直接有効および無効にします。分析設定 UI では、アプリケーションレベルのみでこのプロパティを設定できます。そのため、Java エージェント 4.3 以上では、ティアレベルとノードレベルで Analytics Dynamic Service を無効または有効にすることができません。

Analytics Dynamic Service の設定は、アプリケーションインポートおよび Analytics Dynamic Service import REST API を使用して直接変更できますが、これらのメカニズムのいずれかのみを介して Analytics Dynamic Service の設定を操作すると、対応する analytics-dynamic-service-enabled プロパティではなく、Analytics Dynamic Service の設定が更新されます。そのため、これらのインポートメカニズムのいずれかを使用して Analytics Dynamic Service を有効または無効にして、古い（4.3 より前）エージェントと新しい（4.3 以降）エージェントを組み合わせる場合は、Analytics Dynamic Service の設定値と一致するように関連する analytics-dynamic-service-enabled プロパティを手動で設定する必要があります。また、analytics-dynamic-service-enabled ノードプロパティをアプリケーションインポートの一部として設定し、独自の Import REST API（POST/setAgentProperty でアクセス）を使用することもできます。Configuration Import and Export APIの「Application Analytics Dynamic Service の設定のインポート」を参照してください。

解決済みの問題

既知の問題

• eventTimestamp の集計から作成されたメトリックが期待どおりに機能しない。
• Linux でユニバーサルエージェントを使用して分析エージェントを展開するには、machine-agent モードを使用する必要があります。
• （Windows のみ）分析エージェントがファイルからログデータを収集している場合、「del」コマンドを使用してログファイルを削除することはできません。
• 分析検索の場合：
  • 基本モードでは、正規表現および NOT 論理演算子がフリーテキスト検索でサポートされません。 
  • 基本モードでは、引用符とカンマに特別な意味はありません。
  • Import from 4.1 ボタンを複数回クリックすると、4.1 で保存された検索を複数回インポートできます。
• タイミングの問題により、トランザクション分析の検索を実行した直後にビジネストランザクションのすべての情報が表示されない場合があります。
• EUM をデプロイし、トランザクションおよびログ分析データに対してオンプレミス イベント サービスを使用し、EUM データに対して SaaS イベントサービスを使用している場合は、分析 API を使用してブラウザまたはモバイル要求データを照会できません。
• 開発者モードでデフォルト以外のディレクトリにインストールされている場合、イベントサービスが適切に起動しません。この問題は、オンプレミスの Windows プラットフォームで発生します。