ネットワークエクスペリエンス監視
概要
ネットワークエクスペリエンス監視 (NEM) サービス（旧称 Netscope）は、サービスプロバイダー、企業、ISP、およびサードパーティサービスプロバイダーが、詳細なRadar測定ログと、要約された実用的なデータ形式の標準レポートにアクセスできるようにします。NEMは、顧客がサービスの品質を測定するために使用できるいくつかの標準ログとレポートを提供します。
このソリューションには、「生」のRadar測定値の配信とITMデータAPIへのアクセスが含まれます。NEMは、詳細なデータ（生測定値またはデータ集計値のいずれか）とデータしきい値アラートの両方を提供します。これらのサービスは、プラットフォームピアおよび基盤となるISPにおけるプラットフォームの可用性とパフォーマンスの問題の発見、特定に役立ちます。
Radar「生」測定値: Radar測定値は、イベントごとの詳細情報を提供し、毎日バッチ処理されます。Radar測定値には、タグによって収集された公開コミュニティおよびプライベート測定データが含まれます。HTTPおよびHTTPS測定の可用性、応答時間、スループットなどのデータが含まれます。以下のデータフィールドが提供されます。
- プロバイダーID、リゾルバーIP、難読化された(/28)クライアントIP
- 難読化されたリファラーヘッダー、ユーザーエージェント、エンドユーザーASN
- リゾルバーおよびクライアントフィールドの地理データ
「生」測定で利用可能なRadarメトリックは次のとおりです。
- 可用性、応答時間、スループット（測定時）
- DNSルックアップ時間（オプション）、TCP接続時間（オプション）、セキュア接続時間（オプション）
- レイテンシー（オプション）
- ダウンロード時間（オプション）
Radar測定値は、顧客が収集されたデータの独自の分析を行うことを可能にするために利用できます。データセットには、さまざまな通信プロトコルにおけるプロバイダーのパフォーマンスと可用性（エラー）に関する情報が含まれています。
ログファイルデータは、AWS S3またはGoogle Cloud Storageバケットから7日間利用できます。顧客は、標準のバケットアクセス方法を使用して、コミュニティおよびプライベートデータのログファイルを取得できます。
リアルタイムRadar「生」測定値（オプション）: 生のRadar測定値は、リアルタイムでAWS S3バケットに配信されます。これらのログは通常、収集から5分以内に利用可能になります。これらは、前述のRadar生測定値と同程度の粒度を提供します。
データAPI: ITM RadarデータAPIは、Radarの公開コミュニティおよびプライベート測定データの集計を提供します。データは継続的に更新され、APIによる取得のために約60秒ごとにバッチ処理されます。データAPIは、顧客がRadarデータを独自のレポートやダッシュボードに統合できるように提供されます。
ログ共有と配信
- Radarログはリアルタイムおよび日次で配信できます。
- レポートは毎日実行されます。
- 結果はAWS S3 (S3) またはGoogle Cloud Storage (GCS) に保存されます。
- ログとレポートは両方とも7日間の保持期間があり、作成から1週間後に自動的に削除されます。
- レポートは通常、レポートの種類に応じてTSV（タブ区切り値）またはJSON形式です。
顧客には、S3およびGCSバケットにアクセスするためのログイン情報が提供されます。s3cmdやS3用のAWS CLI、またはGCS用のgsutilのようなコマンドラインツールを使用してログインできます。S3cmd設定ファイルは、ポータルUI経由で受け取ったアクセスキーを認識し、ユーザーがS3バケットに接続するのに役立ちます。
S3に接続してログにアクセスするには、顧客のコンピューターにAWS CLIがインストールされている必要があります。GCSの場合、顧客はポータルUI経由でダウンロードとしてアクセスキーファイルを受け取り、gsutilツールで使用できます。詳細については、FAQを参照してください。
レポートが利用可能になると、顧客は電子メール通知を受け取ります。
プラットフォーム設定
Netscope NEMに必要なデータをサポートおよび生成するようにプラットフォームを設定する必要があります。開始する前に、プラットフォームで以下の設定が有効になっていることを確認してください。
- リソースタイミングの詳細については、Advanced Radar SettingsでInclude Timestampsを有効にします。
ナビゲーション
メインメニューからNetscope NEMを選択します。ネットワークエクスペリエンス監視設定ページが開きます。
プラットフォーム
設定プロセスを開始するために必要なプラットフォームを選択します。
注:
少なくとも1つのプラットフォームまたはネットワークが選択されている場合にのみ、ログとレポートを設定および生成できます。
顧客が受け取る要約データには、選択されたプラットフォーム（関連するすべてのネットワーク）のRadar測定値が含まれます。
プラットフォームの選択
コンテンツサービスプロバイダーまたは企業の場合、CDN、クラウド、データセンター、またはその他のエンドポイントなどのプラットフォームを選択します。測定が必要なプラットフォームを選択します。
Radarログ
- Radarログはプラットフォームで利用できます。
- これらには、生ログで利用可能なフィールドのサブセットが含まれており、一部のデータは匿名化されています：クライアントIP /28、リファラーMD5ハッシュ。
- 公開プラットフォームに対して行われたすべての測定は、測定を生成したページに関係なく提供されます。
注:
- NEMは完全なクライアントIPを公開することはありません。代わりに、/28を公開します。たとえば、255.255.255.255のIPは、レポートでは255.255.255.240/28として表示されます。
- クライアントのGEO情報は、より詳細なクライアントのIPv4に基づいて抽出されます。
ログ頻度
Radarログは毎日（24時間ごと）、つまりUTC時間の1日の終わりに生成できます。ログはリアルタイム（分単位）で生成することもできます。
ファイル形式
TSVまたはJSONを選択して、これらのいずれかの形式でログとレポートを受け取ります。
測定タイプ
以下の測定タイプ（可用性、応答時間、スループット）のログを設定できます。レポートでは、1: 可用性、0: HTTP応答時間、14: HTTPスループット。
リソースタイミングの詳細
はいまたはいいえボタンをクリックして、リソースタイミングの詳細を含めることも選択できます。リソースタイミングの詳細には以下が含まれます。
- DNSルックアップ時間
- TCP接続時間
- セキュア接続時間
- ダウンロード時間
ログの説明については、サービスプロバイダーおよび企業向けRadarログの説明とレポートを参照してください。
ナビゲーションタイミングログ
ログ頻度
ナビゲーションタイミングログは毎日（24時間ごと）、つまりUTC時間の1日の終わりに生成できます。ログはリアルタイム（分単位）で生成することもできます。
ファイル形式
TSVまたはJSONを選択して、これらのいずれかの形式でナビゲーションタイミングログを受け取ります。ログの説明については、ナビゲーションタイミングログの説明を参照してください。
Openmixログ
ログ頻度
Openmixログはリアルタイム（分単位）で生成されます。これらのログは、Openmix顧客のために取得されたリアルタイム測定値を提供します。
ファイル形式
TSVまたはJSONを選択して、これらのいずれかの形式でOpenmixおよびHTTP Openmixログを受け取ります。ただし、JSONが推奨される形式です。
ログの説明については、Openmixログの説明を参照してください。
クラウドサービス配信
このオプションを使用すると、配信モードを選択できます。AWS S3バケットまたはGoogle Cloud Storage (GCS) バケットのいずれかでログとレポートを受け取ることを選択できます。提供されたログイン情報を使用してS3およびGCSバケットにアクセスし、S3にはs3cmdまたはAWS CLIを、GCSにはgsutilコマンドラインを使用できます。
AWS S3
ログとレポートをAWS S3バケットに配信するには、AWS S3を選択します。
場所
場所は、ログとレポートが保存されるAWS S3内のバケットを表します。
IAMキー
AWS S3の下にあるキーの生成ボタンを選択すると、AWS IAMキー（アクセスキーとシークレットキー）が生成され、IAMキーの下に表示されます。後で表示するためにどこにも保存されないため、必ずキーを記録してください。
注:
アクセスキーとシークレットキーのペアは、プライベートキーの唯一のコピーです。顧客はそれらを安全に保管する必要があります。新しいキーを再生成すると、既存のキーは無効になります。 S3cmd設定ファイルは、ポータルUI経由で受け取ったアクセスキーを認識し、顧客がS3バケットに接続するのに役立ちます。S3に接続するには、顧客のマシンにAWS CLIがインストールされている必要があります。
s3cmdでアクセスキーとシークレットキーを使用してS3バケットからレポートをダウンロードする方法については、FAQを参照してください。
Google Cloud Storage
ログとレポートをGCSに配信するには、Google Cloud Storageを選択します。
場所
場所は、ログとレポートが保存されるGoogle Cloud Storage内のバケットを表します。
IAMキー
キーファイルの生成ボタンを選択すると、Googleサービスアカウントキーファイルがマシンにダウンロードされます。
注:
このキーファイルは、プライベートキーの唯一のコピーとして機能します。サービスアカウントのメールアドレスをメモし、サービスアカウントのプライベートキーファイルを安全に保管してください。新しいキーファイルを再生成すると、既存のファイルは無効になります。
このキーファイルは、gsutilツールで使用して、GCSバケットからログとレポートをダウンロードできます。キーファイルを使用してログファイルをダウンロードする方法の詳細については、FAQを参照してください。
サービスプロバイダーおよび企業向けRadarログの説明とレポート
プロバイダー向けRadarログ
- これらのログは、ベンチマークパートナー向けのRadar測定値を提供します。
- これらは、測定を生成したページに関係なく、公開プラットフォームに対して行われたすべての測定値を提供します。
- Radarログには、生ログで利用可能なフィールドのサブセットが含まれており、一部のデータは匿名化されています：クライアントIP /28、リファラーMD5ハッシュ。
- こちらはTSVファイル形式のプラットフォームRadarログ共有のサンプルです。
注:
- NEMは完全なクライアントIPを公開することはありません。代わりに、/28を公開します。たとえば、255.255.255.255のIPは、レポートでは255.255.255.240/28として表示されます。
- クライアントのGEO情報は、より詳細なクライアントのIPv4に基づいて抽出されます。
ログの説明
以下は、Radarログの列ヘッダーと説明です。フィールドは出力ファイルに以下の順序で表示されます。
| ログ | 説明 |
|---|---|
| Timestamp | UTC時間、YYYY-MM-DDTHH:MI:SSZ形式。実際の値（秒単位）は、ログテーブルでは最も近い時間（2018-03-30T23:00:00Z）に、日テーブルでは最も近い日（2018-03-30T00:00:00Z）に丸められます。タイムスタンプはすべてのデータセットで常にUTCです。 |
| Unique Node ID | キャッシュノードIDとも呼ばれます。任意の値です。通常、CDNエッジサーバーが特定の要求を処理したサーバーを内部的に識別するのに役立つIPです。’’ (空の文字列): UNI検出をサポートしないRadarクライアントから来ます。0: ユーザーエージェントがUNI検出に必要な機能をサポートしていません。1: クライアントは、HTTP 404やその他の失敗した応答など、UNI検出中にエラーが発生しました。2: UNI検出が試行されましたが、エラーが発生しました。 |
| Provider ID | 測定対象のプラットフォームの内部ID。 |
| Probe Type | 測定対象のプローブタイプ（例：1: HTTP接続時間、0: HTTP応答時間、14: HTTPスループットなど）。サービスが利用可能であることを示すには、許可された時間内に正常に返された情報を使用します。 |
| Response Code | 測定結果。例：0: 成功、1: タイムアウト、4: エラー。可用性計算の場合、測定のパーセンテージは、0（成功）応答を持つ測定値と全体の測定値（応答に関係なく合計）の比率で計算されます。他のプローブタイプ（RTTとスループット）の場合、RTTの統計を計算する際には、0の成功コードを持つRTTデータポイントのみを考慮する必要があります。スループットも同様です。 |
| Measurement Value | 記録された測定値。その意味はプローブタイプによって異なります。可用性（1）/応答時間（0）測定はミリ秒単位で、スループット（14）はkbps単位で表されます。 |
| Resolver Market | 要求を処理したDNSリゾルバーの市場。通常、DNSリゾルバーが位置する大陸。0: 不明 (XX)、1: 北米 (NA)、5: アフリカ (AF)、3: ヨーロッパ (EU)、4: アジア (AS)、2: オセアニア (OC)、6: 南米 (SA)。 |
| Resolver Country | 要求を処理したDNSリゾルバーの国。IDはhttps://community-radar.citrix.com/ref/countries.json.gzで名前にマッピングできます。 |
| Resolver Region | 要求を処理したDNSリゾルバーの地域。IDはhttps://community-radar.citrix.com/ref/regions.json.gzで名前にマッピングできます。注: 世界のすべての国に地域が定義されているわけではありません。 |
| Resolver State | 要求を処理したDNSリゾルバーの州。IDはhttps://community-radar.citrix.com/ref/states.json.gzで名前にマッピングできます。注: 世界のすべての国に州が定義されているわけではありません。 |
| Resolver City | 要求を処理したDNSリゾルバーの都市。リゾルバーIPアドレスを検索して追加されます。IDはhttps://community-radar.citrix.com/ref/cities.json.gzで名前にマッピングできます。 |
| Resolver ASN | 要求を処理したDNSリゾルバーの自律システム番号（ASN）。通常、DNSリゾルバーを持つASN。IDはhttps://community-radar.citrix.com/ref/asns.json.gzで名前にマッピングできます。 |
| Resolver IP | 当社のインフラストラクチャがDNS要求を受信したDNSリゾルバーのIPアドレス。 |
| Client Market | この測定を生成したエンドユーザーの市場。通常、クライアントIPが位置する大陸。0: 不明 (XX)、1: 北米 (NA)、5: アフリカ (AF)、3: ヨーロッパ (EU)、4: アジア (AS)、2: オセアニア (OC)、6: 南米 (SA)。 |
| Client Country | この測定を生成したエンドユーザーの国。IDはhttps://community-radar.citrix.com/ref/countries.json.gzで名前にマッピングできます。 |
| Client Region | この測定を生成したエンドユーザーの地域。通常、クライアントIPが位置する地理的地域。IDはhttps://community-radar.citrix.com/ref/regions.json.gzで名前にマッピングできます。注: 世界のすべての国に地域が定義されているわけではありません。 |
| Client State | この測定を生成したエンドユーザーの州。通常、クライアントIPが位置する州。注: 世界のすべての国に州が定義されているわけではありません。 |
| Client City | この測定を生成したエンドユーザーの都市。通常、クライアントIPが位置する都市。IDはhttps://community-radar.citrix.com/ref/cities.json.gzで名前にマッピングできます。 |
| Client ASN | この測定を生成したエンドユーザーの自律システム番号（ASN）。通常、クライアントIPを含むASN。IDはhttps://community-radar.citrix.com/ref/asns.json.gzで名前にマッピングできます。 |
| Client IP | この測定を生成したエンドユーザーのIP。 |
| Referer Host MD5 | リファラー情報（プロトコル、ホスト、パス）は、RadarへのHTTP要求のリファラーヘッダーから取得されます。リファラーホストはMD5ハッシュ化されます。 |
| User Agent | タグをホストしているブラウザページからのユーザーエージェント文字列です。たとえば、Chromeを使用してRadarタグのあるページを閲覧すると、バックグラウンドのRadar測定値はChromeブラウザからのユーザーエージェントを記録します。測定値には、Chromeブラウザ、Chromeのバージョン、Chromeが実行されているOSに関する情報などが含まれます。 |
| DNS Lookup Time (Optional) | リソースタイミングAPIを使用すると、ドメインルックアップ終了とドメインルックアップ開始の差が計算されます。両方の値がnullではなく、終了時間が開始時間よりも大きい場合に計算されます。domainLookupEnd - domainLookupStartとして計算されます。 |
| TCP Connect Time (Optional) | リソースタイミングAPIを使用すると、接続終了と接続開始の差が計算されます。両方の値がnullではなく、終了時間が開始時間よりも大きい場合に計算されます。connectEnd - connectStartとして計算されます。 |
| Secure Connect Time (Optional) | リソースタイミングAPIを使用すると、接続終了とセキュア接続開始の差が計算されます。両方の値がnullではなく、終了時間が開始時間よりも大きい場合に計算されます。connectEnd - secureConnectionStartとして計算されます。 |
| Latency (Optional) | リソースタイミングAPIを使用すると、応答開始と要求開始の差が計算されます。両方の値がnullではなく、応答開始時間が要求開始時間よりも大きい場合に計算されます。responseStart - requestStartとして計算されます。 |
| Download Time (Optional) | リソースタイミングAPIを使用すると、応答終了と応答開始の差が計算されます。両方の値がnullではなく、終了時間が開始時間よりも大きい場合に計算されます。responseEnd - responseStartとして計算されます。 |
| Client Profile | このフィールドは、データがモバイルアプリまたはブラウザのどちらから来ているかを識別するのに役立ちます。また、iOS、Androidアプリ、ブラウザを区別することもできます。各クライアントプロファイルを識別するために番号が使用されます。このフィールドの値は、null、0、1、2、3、4です。ここで、null: 通常、client_profile値を送信することをサポートしない古いRadarクライアントを意味します。0: ブラウザ; 1: iOS - Swiftで書かれたiOSアプリ用のRadarランナー; 2: Android; 3: モバイル版ウェブサイトのブラウザ; 4: iOS - Objective-Cで書かれたiOSアプリ用のRadarランナー。 |
| Client Profile Version | クライアントプロファイルバージョンは、モバイルアプリで使用されたRadar Runnerコード（iOSの場合）またはAndroidRadar SDK（Androidの場合）のバージョンを示します。このフィールドは内部使用のみを目的としています。 |
| Device Category | すべてのデバイスは、スマートフォン、タブレット、PC、スマートTV、その他のいずれかに分類されます。「その他」は、パーサーがフィールドの値を判断できない場合のデフォルト値として使用されます。 |
| Device | ユーザーが使用しているデバイスの種類。たとえば、Apple iPhone。ユーザーエージェント文字列は、Radarタグをホストしているページで実行されているブラウザからこれを検出します。 |
| Browser | ユーザーが使用しているブラウザの種類。たとえば、Mobile Safari UI/WKWebView 0.0.0。ユーザーエージェント文字列は、Radarタグをホストしているページで実行されているブラウザからこれを検出します。 |
| OS | 使用されているオペレーティングシステム。たとえば、iOS 11.0.3。ユーザーエージェント文字列は、Radarタグをホストしているページで実行されているブラウザからこれを検出します。 |
| Reporting Client IP | このIPは、測定を行っているユーザーのマスクされた/48パブリックIPです。IPv4またはIPv6（サポートされている場合）のいずれかです。 |
ナビゲーションタイミングログの説明
ナビゲーションタイミングデータ
ナビゲーションタイミングデータは、ウェブページのページロードプロセスのさまざまな部分に関する洞察を提供します。
このデータは、エンドユーザーの場所、ネットワークの問題、プロバイダーによる変更などによって異なります。顧客はナビゲーションタイミングデータを使用して、監視対象のウェブページのロードにおけるエンドユーザーのエクスペリエンスを最適化できます。
すべてのRadarセッションに対して測定を行うことができます（有効な場合）。各セッションには、セッションからのすべての測定値を追跡するのに役立つID番号が割り当てられます。これらの測定値は、NEMを介してナビゲーションタイミングログとして顧客と共有されます。
以下は、TSVファイル形式のナビゲーションタイミングデータのサンプルです。
以下は、ナビゲーションタイミングログの列ヘッダーと説明です。フィールドは出力ファイルに以下の順序で表示されます。
| ログ | 説明 |
|---|---|
| Timestamp | UTC時間、YYYY-MM-DDTHH:MI:SSZ形式。実際の値（秒単位）は、ログテーブルでは最も近い時間（2018-03-30T23:00:00Z）に、日テーブルでは最も近い日（2018-03-30T00:00:00Z）に丸められます。すべてのデータセットで常にUTCです。 |
| Response Code | 測定結果。例：0: 成功、1: タイムアウト、4: エラー。可用性計算の場合、測定のパーセンテージは、0（成功）応答を持つ測定値と全体の測定値（合計）の比率で計算されます。他のプローブタイプ（RTTとスループット）の場合、RTTの統計を計算する際には、0の成功コードを持つRTTデータポイントのみを考慮する必要があります。スループットも同様です。 |
| Resolver Market | 要求を処理したDNSリゾルバーの市場。通常、DNSリゾルバーが位置する大陸。0: 不明 (XX)、1: 北米 (NA)、5: アフリカ (AF)、3: ヨーロッパ (EU)、4: アジア (AS)、2: オセアニア (OC)、6: 南米 (SA)。 |
| Resolver Country | 要求を処理したDNSリゾルバーの国。IDはhttps://community-radar.citrix.com/ref/countries.json.gzで名前にマッピングできます。 |
| Resolver Region | 要求を処理したDNSリゾルバーの地域。IDはhttps://community-radar.citrix.com/ref/regions.json.gzで名前にマッピングできます。世界のすべての国に地域が定義されているわけではありません。 |
| Resolver State | 要求を処理したDNSリゾルバーの州。IDはhttps://community-radar.citrix.com/ref/states.json.gzで名前にマッピングできます。世界のすべての国に州が定義されているわけではありません。 |
| Resolver ASN | 要求を処理したDNSリゾルバーの自律システム番号（ASN）。通常、DNSリゾルバーを持つASN。IDはhttps://community-radar.citrix.com/ref/asns.json.gzで名前にマッピングできます。 |
| Resolver IP | 当社のインフラストラクチャがDNS要求を受信したDNSリゾルバーのIPアドレス。 |
| Client Market | この測定を生成したエンドユーザーの市場。通常、クライアントIPが位置する大陸。0: 不明 (XX)、1: 北米 (NA)、5: アフリカ (AF)、3: ヨーロッパ (EU)、4: アジア (AS)、2: オセアニア (OC)、6: 南米 (SA)。 |
| Client Country | この測定を生成したエンドユーザーの国。IDはhttps://community-radar.citrix.com/ref/countries.json.gzで名前にマッピングできます。 |
| Client Region | この測定を生成したエンドユーザーの地域。通常、クライアントIPが位置する地理的地域。IDはhttps://community-radar.citrix.com/ref/regions.json.gzで名前にマッピングできます。世界のすべての国に地域が定義されているわけではありません。 |
| Client State | この測定を生成したエンドユーザーの州。通常、クライアントIPが位置する州。IDはhttps://community-radar.citrix.com/ref/states.json.gzで名前にマッピングできます。世界のすべての国に州が定義されているわけではありません。 |
| Client ASN | この測定を生成したエンドユーザーの自律システム番号（ASN）。通常、クライアントIPを持つASN。IDはhttps://community-radar.citrix.com/ref/asns.json.gzで名前にマッピングできます。 |
| Client IP | 測定を生成したエンドユーザーのIP。 |
| Referer Host | リファラー情報（プロトコル、ホスト、パス）は、RadarへのHTTP要求のリファラーヘッダーから取得されます。 |
| Referer Protocol | リファラー情報（プロトコル、ホスト、パス）は、RadarへのHTTP要求のリファラーヘッダーから取得されます。 |
| Referer Path | リファラー情報（プロトコル、ホスト、パス）は、RadarへのHTTP要求のリファラーヘッダーから取得されます。 |
| Device Category | すべてのデバイスは、スマートフォン、タブレット、PC、スマートTV、その他のいずれかに分類されます。「その他」は、パーサーがフィールドの値を判断できない場合のデフォルト値として使用されます。 |
| Device | ユーザーが使用しているデバイスの種類。たとえば、Apple iPhone。ユーザーエージェント文字列は、Radarタグをホストしているページで実行されているブラウザからこれを検出します。 |
| Browser | ユーザーが使用しているブラウザの種類。たとえば、Mobile Safari UI/WKWebView 0.0.0。ユーザーエージェント文字列は、Radarタグをホストしているページで実行されているブラウザからこれを検出します。 |
| OS | 使用されているオペレーティングシステム。たとえば、iOS 11.0.3。ユーザーエージェント文字列は、Radarタグをホストしているページで実行されているブラウザからこれを検出します。 |
| DNS Lookup Time | リソースタイミングAPIを使用すると、ドメインルックアップ終了とドメインルックアップ開始の差が計算されます。両方の値がnullではなく、終了時間が開始時間よりも大きい場合に計算されます。domainLookupEnd - domainLookupStartとして計算されます。 |
| TCP Connect Time | リソースタイミングAPIを使用すると、接続終了と接続開始の差が計算されます。両方の値がnullではなく、終了時間が開始時間よりも大きい場合に計算されます。connectEnd - connectStartとして計算されます。 |
| Secure Connect Time | リソースタイミングAPIを使用すると、接続終了とセキュア接続開始の差が計算されます。両方の値がnullではなく、終了時間が開始時間よりも大きい場合に計算されます。connectEnd - secureConnectionStartとして計算されます。 |
| Load Event | ロードイベントの開始から終了までの期間または時間。両方の値がnullではなく、終了時間が開始時間よりも大きい場合に、LoadEventEnd - LoadEventStartとして計算されます。 |
| Redirect | ナビゲーション開始からフェッチ開始までの期間または時間。両方の値がnullではなく、終了時間が開始時間よりも大きい場合に、FetchStart - NavigationStartとして計算されます。 |
| Total Page Load | ナビゲーション開始からページロードイベント終了までの期間または時間。両方の値がnullではなく、終了時間が開始時間よりも大きい場合に、Load Event End - Navigation Startとして計算されます。 |
| DOM | DOMロードからDOM完了までの期間または時間。両方の値がnullではなく、終了時間が開始時間よりも大きい場合に、DomComplete - DomLoadingとして計算されます。 |
| Latency | リソースタイミングAPIを使用すると、応答開始と要求開始の差が計算されます。両方の値がnullではなく、応答開始時間が要求開始時間よりも大きい場合に計算されます。responseStart - requestStartとして計算されます。 |
| Download Time | リソースタイミングAPIを使用すると、応答終了と応答開始の差が計算されます。両方の値がnullではなく、終了時間が開始時間よりも大きい場合に計算されます。responseEnd - responseStartとして計算されます。 |
| DOM interactive | ナビゲーション開始からDOMインタラクティブまでの期間または時間。両方の値がnullではなく、終了時間が開始時間よりも大きい場合に、DomInteractive - NavigationStartとして計算されます。 |
| Start Render | ナビゲーション開始からレンダリング開始までの期間または時間。両方の値がnullではなく、終了時間が開始時間よりも大きい場合に、startRender - NavigationStartとして計算されます。 |
OpenmixおよびHTTP Openmixログ
OpenmixおよびHTTP Openmixログを使用すると、顧客はリアルタイム測定値を使用してOpenmixアプリの動作を監視できます。このデータを使用して、改善点を見つけたり、アプリの期待されるパフォーマンスを確認したりできます。
- これらのログは、Openmix顧客のために取得されたリアルタイム測定値を提供します。
- これらのログの推奨ファイル形式はJSONですが、TSV形式でも利用できます。
- こちらは、TSVファイル形式のOpenmixおよびHTTP Openmixログ共有データのサンプルです。
Openmixログの説明
| ログ | 説明 |
|---|---|
| Timestamp | UTC時間、YYYY-MM-DDTHH:MI:SSZ形式。実際の値（秒単位）は、ログテーブルでは最も近い時間（2018-03-30T23:00:00Z）に、日テーブルでは最も近い日（2018-03-30T00:00:00Z）に丸められます。タイムスタンプはすべてのデータセットで常にUTCです。 |
| App Owner Zone ID | 要求を処理するアプリケーション所有者のゾーンID。この値は常に1です。 |
| App Owner Customer ID | 要求を処理するアプリケーション所有者の顧客ID。HTTP要求の場合、このIDは要求パスにコード化され、実行するアプリケーションを検索するために使用されます。 |
| App ID | 要求を処理する顧客アカウント内のアプリケーションID。このIDもHTTP要求パスにコード化されます。アプリケーションIDは1から始まり、顧客に対してのみ一意です。特定のアプリIDのクエリは、appOwnerCustomerIdでクエリすることで完全に修飾する必要があります。 |
| App Version | アカウントを処理したアプリケーションのバージョン。ポータルまたはAPIを介してアプリケーションが更新されるたびに、バージョンはインクリメントされます。要求時に実行されていたバージョンが記録されます。この情報は、アプリケーションが更新されるにつれて、時間の経過とともにバージョン管理されたロジックを分離するために使用できます。ネットワーク全体にわたるホストは、通常、同様の期間で更新を受け取りますが、正確に同じ瞬間ではありません。更新プロセス中に、異なるバージョンのアプリが重複する決定で使用される可能性があります。 |
| App Name | アカウントを処理したアプリケーションの名前。 |
| Market | この測定を生成したエンドユーザーの市場。 |
| Country | この測定を生成したエンドユーザーの国。 |
| Region | この測定を生成したエンドユーザーの地域。 |
| State | この測定を生成したエンドユーザーの州。 |
| ASN ID | この測定を生成したエンドユーザーの自律システム番号（ASN）。通常、クライアントIPを持つ自律システム番号。 |
| ASN Name | 測定を生成したエンドユーザーのASNの名前。 |
| Effective IP | 有効なIPは、要求を処理するために使用されるIPです。これは、要求IPをオーバーライドするクエリ文字列で指定されたIPです（リゾルバー/ECS/EDNS IDとDNSフローの場合）。これは、システムが情報を処理する際にターゲットと見なすアドレスです。このIPは、要求リゾルバーのIP、またはEDNS ECSがサポートされている場合はクライアントのECS IPアドレスのいずれかです。したがって、アプリケーションロジックに渡されるすべてのプローブパフォーマンスデータ、地理情報などは、このIPに基づいています。 |
| Resolver Market | 要求を処理したDNSリゾルバーの市場。 |
| Resolver Country | 要求を処理したDNSリゾルバーの国。 |
| Resolver Region | 要求を処理したDNSリゾルバーの地域。 |
| Resolver State | 要求を処理したDNSリゾルバーの州。 |
| Resolver ASN ID | 要求を処理したDNSリゾルバーの自律システム番号（ASN）。通常、DNSリゾルバーを持つ自律システム番号。 |
| Resolver ASN Name | 要求を処理したリゾルバーのASNの名前。 |
| Resolver IP | 当社のインフラストラクチャがDNS要求を受信したDNSリゾルバーのIPアドレス。 |
| Decision Provider Name | アプリケーションが選択するプラットフォームのエイリアス。 |
| Reason Code | 決定の理由を説明するためにアプリケーション内で設定された理由コード。 |
| Reason Log | このログは、Openmixアプリからの顧客定義の出力です。これは、顧客がOpenmixアプリの決定に関する情報をログに記録できるようにするオプションの文字列フィールドです。 |
| Fallback Mode | このモードは、要求を処理したときにアプリがフォールバックモードであったかどうかを示します。フォールバックは、実行のために要求の準備中に何らかの障害が発生した場合に発生します。 |
| Used EDNS | アプリケーションがEDNSクライアントサブネット拡張を使用している場合はTrue。 |
| TTL | 返されたTTL（Time To Live）。 |
| Response | 要求から返されたCNAME。 |
| Result | このフィールドの値は常に1です。 |
| Context | 要求が処理されたときにOpenmixで利用可能だったRadarデータの要約です。Openmixは、すべての要求に対して有効な値に関連してRadarデータを解決するため、同時に要求を行う2つのクライアントは異なるコンテキスト文字列を持つことができます。 |
Openmix HTTP APIログの説明
| ログ | 説明 |
|---|---|
| Timestamp | UTC時間、YYYY-MM-DDTHH:MI:SSZ形式。実際の値（秒単位）は、ログテーブルでは最も近い時間（2018-03-30T23:00:00Z）に、日テーブルでは最も近い日（2018-03-30T00:00:00Z）に丸められます。タイムスタンプはすべてのデータセットで常にUTCです。 |
| App Owner Zone ID | 要求を処理するアプリケーション所有者のゾーンID。この値は常に1です。 |
| App Owner Customer ID | 要求を処理するアプリケーション所有者の顧客ID。HTTP要求の場合、このIDは要求パスにコード化され、実行するアプリケーションを検索するために使用されます。 |
| App ID | 要求を処理する顧客アカウント内のアプリケーションID。このIDもHTTP要求パスにコード化されます。アプリケーションIDは1から始まり、顧客に対してのみ一意です。特定のアプリIDのクエリは、appOwnerCustomerIdでクエリすることで完全に修飾する必要があります。 |
| App Version | アカウントを処理したアプリケーションのバージョン。ポータルまたはAPIを介してアプリケーションが更新されるたびに、バージョンはインクリメントされます。要求時に実行されていたバージョンが記録されます。この情報は、アプリケーションが更新されるにつれて、時間の経過とともにバージョン管理されたロジックを分離するために使用できます。ネットワーク全体にわたるホストは、通常、同様の期間で更新を受け取りますが、正確に同じ瞬間ではありません。更新プロセス中に、異なるバージョンのアプリが重複する決定で使用される可能性があります。 |
| App Name | アカウントを処理したアプリケーションの名前。 |
| Market | この測定を生成したエンドユーザーの市場。 |
| Country | この測定を生成したエンドユーザーの国。 |
| Region | この測定を生成したエンドユーザーの地域。 |
| State | この測定を生成したエンドユーザーの州。 |
| ASN ID | この測定を生成したエンドユーザーの自律システム番号（ASN）のID。つまり、ASN名に関連付けられたネットワークID番号。 |
| ASN Name | 測定を生成したエンドユーザーのASNの名前。 |
| Effective IP | 有効なIPは、要求を処理するために使用されるIPです。これは、要求IPをオーバーライドするクエリ文字列で指定されたIPです（リゾルバー/ECS/EDNS IDとDNSフローの場合）。これは、システムが情報を処理する際にターゲットと見なすアドレスです。このIPは、要求リゾルバーのIP、またはEDNS ECSがサポートされている場合はクライアントのECS IPアドレスのいずれかです。すべてのプローブパフォーマンスデータ、地理情報などは、このIPに基づいています。 |
| Decision Provider Name | アプリケーションが選択するプラットフォームのエイリアス。 |
| Reason Code | 決定の理由を説明するためにアプリケーション内で設定された理由コード。 |
| Reason Log | このログは、Openmixアプリからの顧客定義の出力です。これは、顧客がOpenmixアプリの決定に関する情報をログに記録できるようにするオプションの文字列フィールドです。 |
| Fallback Mode | このモードは、要求を処理したときにアプリがフォールバックモードであったかどうかを示します。フォールバックは、実行のために要求の準備中に何らかの障害が発生した場合に発生します。 |
| Response Code | 測定結果。例：0: 成功、1: タイムアウト、4: エラー。可用性計算の場合、測定のパーセンテージは、0（成功）応答を持つ測定値と全体の測定値（応答に関係なく合計）の比率で計算されます。他のプローブタイプ（RTTとスループット）の場合、RTTの統計を計算する際には、0の成功コードを持つRTTデータポイントのみを考慮する必要があります。スループットも同様です。 |
| HTTP Method | HTTPメソッド（GET/POST/OPTIONSなど）は、顧客サービスからHTTP Openmixサーバーに対して行われた要求に関連します。これらのメソッドは、インバウンドURLの一部とアウトバウンドHTTP応答を構成します。 |
| URI | 要求パスです。顧客が望む動作を得られない場合、それは不適切に構造化された要求が原因である可能性があります。ログには、当社のサーバーが受信しているもの（プロトコル、ホスト、パス）が表示されます。リファラー情報（プロトコル、ホスト、パス）は、RadarへのHTTP要求のリファラーヘッダーから取得されます。HTTP OPXの場合、リファラー全体（プロトコル、ホスト、パス）は、リファラーというラベルの1つの文字列に含まれます。 |
| User Agent | タグをホストしているブラウザページからのユーザーエージェント文字列です。たとえば、Chromeを使用してRadarタグのあるページを閲覧すると、バックグラウンドのRadar測定値はChromeブラウザからのユーザーエージェントを記録します。測定値には、Chromeブラウザ、Chromeのバージョン、Chromeが実行されているOSに関する情報などが含まれます。 |
| Context | 要求が処理されたときにOpenmixで利用可能だったRadarデータの要約です。Openmixは、すべての要求に対して有効な値に関連してRadarデータを解決するため、同時に要求を行う2つのクライアントは異なるコンテキスト文字列を持つことができます。 |
サードパーティ組織向けカスタムレポート
顧客はNetScaler®と協力して、NetScalerが収集するRadarデータに基づいたカスタムレポートを取得できます。NetScalerは、スケジュールに基づいて実行するレポートを生成できます。レポートはデータファイルとして、通常はTSV形式で利用できます。
FAQ
Radar
ファイルはどのくらいの頻度でS3およびGCSにプッシュされますか
ファイルの預け入れ頻度は、Radarでは1分に1回、レポートでは毎日です。
レポートはどこに保存されますか
S3レガシー（場所1）：
s3://public-radar/[customer name]/
S3（場所2）：
s3://cedexis-netscope/[customer id]/
GCS（場所3）：
gs://cedexis-netscope-[customer id]/
S3アクセス認証情報がまだない場合、どのように取得しますか
ポータルは「アクセス」キーと「シークレット」キーを提供します。これらのキーを「s3cmd」、「awscli」、またはその他のツールで使用してS3にアクセスします。Google Storageの場合、ポータルは「gsutil」ツールで使用するアクセス認証情報を含むファイルをダウンロードします。
s3cmdでアクセスキーとシークレットキーを使用してS3バケットからログとレポートをダウンロードする方法
まず、https://s3tools.org/downloadからs3cmdをダウンロードしてインストールし、使用法、オプション、コマンドについてはhttps://s3tools.org/usageを参照する必要があります。次に、以下のコマンドを実行します。
s3cmd --access_key=[access key] --secret_key=[secret key] ls s3://cedexis-netscope/<customer id>/radar/
<!--NeedCopy-->
ファイルをダウンロードするには、以下のコマンドを実行します。
s3cmd --access_key=[access_key] --secret_key=[secret_key] get s3://cedexis-netscope/<customer id>/radar/[the_filename_to_download] [the_name_of_the_local_file]
<!--NeedCopy-->
s3cmd設定を使用してS3バケット内のファイルを一覧表示する方法
最初のステップはs3cmdをインストールすることです。http://s3tools.org/downloadからインストールできます。
s3cmdを設定するには、以下のコマンドを実行します。
s3cmd ls s3://cedexis-netscope/[customer id]/
<!--NeedCopy-->
別のアクセスキーとシークレットキーのセットでs3cmdをすでに使用している場合は、以下の手順に従ってください。
s3cmdをすでに使用している場合は、デフォルトの設定ファイル~/.s3cfgをコピーしてください。たとえば、コピーを作成し、~/.s3cfg_netscopeという名前を付けます。~/.s3cfg_netscope内のアクセスキーとシークレットキーのエントリを、当社が提供するものに置き換えます。
デフォルトの設定（貴社のもの）の代わりに新しい設定を使用して、以下のコマンドでS3バケットにアクセスします。
s3cmd -c ~/.s3cfg_netscope ls s3://cedexis-netscope/[customer id]/
<!--NeedCopy-->
主な違いは、-cと、NetScalerが提供するアクセスキーとシークレットキーを含む設定ファイルの場所を指定する必要があることです。
キーのセットを切り替えたい場合は、それらをファイルに埋め込みます。-cオプションでファイルを指定して、使用しているキーペアを指定します。
注:
-cパラメーターは、アクセスキーとシークレットキーを含む設定ファイルの場所を示します。
gsutilまたはgcloudでキーファイルを使用してログファイルをダウンロードする方法
GoogleサービスアカウントJSONキーファイルをダウンロードしたら、それを使用してGoogleアカウントの認証情報を認証したり、ログファイルを表示またはダウンロードしたりできます。たとえば、Googleのgcloudおよびgsutilコマンドラインユーティリティを使用してそれを行う1つの方法を以下に示します。
ステップ1: キーファイルをアクティブ化する
gcloudまたはgsutilコマンドを実行するためにキーファイルを認証するには、認証コマンドgcloud auth activate-またはgsutil config -eが必要です。
gcloudの場合:
ダウンロードしたキーファイルを使用して、以下のコマンドを実行します。
gcloud auth activate-service-account --key-file [downloaded config file]
<!--NeedCopy-->
または
gcloud auth activate-service-account --key-file=[path and file name of key file]
<!--NeedCopy-->
gsutilの場合:
ダウンロードした設定ファイルを使用して、以下のコマンドを実行します。
gsutil config -e
<!--NeedCopy-->
ステップ2: GCS（Google Cloud Storage）バケット内のファイルを一覧表示する
前のステップで説明したようにサービスアカウントキーファイルをアクティブ化したら、以下のコマンドを使用してGCSバケット内のファイルを一覧表示します。
gsutil ls gs://cedexis-netscope-<customer id>
<!--NeedCopy-->
ステップ3（必要な場合）：元の認証情報を復元する（またはアカウントを切り替える）
以下の手順で、NetScaler ITMアカウントと認証済みの他のGoogle Cloud認証情報を切り替えることができます。
まず、以下のコマンドを実行してすべてのアカウントを一覧表示します。
gcloud auth list
<!--NeedCopy-->
次に、以下のコマンドを使用して別のアカウントに切り替えます。
gcloud config set account [email of the account to switch to as shown in gcloud auth list]
<!--NeedCopy-->
同じコマンドを使用して、切り替えたいアカウントのメールアドレスに置き換えることで、アカウント間を切り替えることができます。
ファイル名はどのようになりますか
レガシー日次:
Radar日次ログ共有ファイル名には、この構造があります。
<prefix><date: YYYY-MM-DD>.<customer_id>.part<uniq_id>.kr.txt.gz
例：Cedexis_Daily-2017-11-07.21222.part-cc901e1dd55eal4e.kr.txt.gz（非標準の例）
レガシーリアルタイム:
Radarリアルタイムログ共有ファイル名には、この構造があります。
<prefix><customer_id>-YYYY-MM-DDTHH:MM<uniq_id>.txt.gz
例：Cedexis_3-32291-2017-11-08T20:56-cc907e8fd71eaf4e.txt.gz
Netscope NEM形式:
日次およびリアルタイムログ共有ファイルのNetscope NEM形式には、この構造があります。
<freq><log_type><prefix><id_type><id><iso_dt><uniq_id>.<line_format>.gz
ここで、
-
freq:"daily" | "rt" | "hr" -
log_type:"radar" | "opx" | "hopx" -
prefix:log_share.prefix -
id_type:"customer" | "provider" | "asn" -
id:log_share.match_id -
iso_dt:iso 8601 Date_time "YYYYMMDDTHHMMSSZ" -
uniq_id:hash(UUID) -
line_format:"tsv" | "json"
例：rt-radar-TestRadar1-provider-20363-20171209183034Z-cc907e8fd71eaf4e.tsv.gz
出力ファイルの形式は何ですか
Radarの場合、出力ファイル形式はTSV（タブ区切り値）、gzip圧縮です。
OpenmixおよびOpenmix HTTP API
ファイルはどのくらいの頻度でS3にプッシュされますか
ファイルの預け入れ頻度は、OpenmixおよびHTTP Openmixでは1分に1回です。
OpenmixおよびOpenmix HTTP APIリアルタイムログ共有を設定するオプションが表示されない場合はどうすればよいですか
アカウントマネージャーは、OpenmixおよびOpenmix HTTP APIリアルタイムログ共有を設定および有効にするために必要なロールを有効にできます。
OpenmixおよびOpenmix HTTP APIリアルタイムログ共有を有効にしてファイルにアクセスする方法
アカウントでロールが有効になると、ログの管理アイコンが表示されます。クリックしてログダイアログを開くと、Openmixログ設定にアクセスできます。これらの設定は、OpenmixおよびHTTP Openmixリアルタイムログ共有を有効にし、ファイルにアクセスするために必要なすべてです。
バックエンドプロセスは何ですか
Openmixログ共有を有効にすると、Openmix HTTP APIログ共有も有効になります。OpenmixおよびOpenmix HTTP APIログ共有サービスは、顧客のために10分以内にログの出力を開始する必要があります。
OpenmixおよびHTTP Openmixレポートはどこに保存されますか
S3レガシー（場所1）：
s3://logshare/[zone ID]/[customer ID]/logs/openmix/json/[YYYY]/[MM]/[DD]/[HH]/.
S3（場所2）：
s3://cedexis-netscope/[customer id]/
GCS（場所3）：
gs://cedexis-netscope-[customer id]/
ファイル名はどのようになりますか
OpenmixおよびHTTP Openmixのファイル名構造は通常、次のようになります。
レガシーリアルタイム:
[zone ID, 1][customerID]-openmix-json[YYYY][MM][DD][HH][mm][ss]Z-m1-w9-c0.gz
Netscope NEM形式:
日次およびリアルタイムログ共有ファイルのNetscope NEM形式には、この構造があります。
<freq><log_type><prefix><id_type><idv><iso_dt><uniq_id>.<line_format>.gz
ここで、
-
freq:"daily" | "rt" | "hr" -
log_type:"radar" | "opx" | "hopx" -
prefix:log_share.prefix -
id_type:"customer" | "provider" | "asn" -
idv:log_share.match_id -
iso_dt:iso 8601 Date_time "YYYYMMDDTHHMMSSZ" -
uniq_id:hash(UUID) -
line_format:"tsv" | "json"
例：hr-opx-TestOpenmix1-provider-20363-20171209183034Z-cc907e8fd71eaf4e.tsv.gz
出力ファイルの形式は何ですか
OpenmixおよびOpenmix HTTP APIのファイル形式はJSON（gzip圧縮）です。