管理 Log-Level レポート
注:
このサービスは現在、限られた一連のクライアントと Microsoft の従業員のみが利用できます。
管理 Log-Level レポート (別名ハニカム) を使用すると、Xandr 管理者はログ レベルのデータに対して選択クエリを簡単かつ安全に実行できます。 このページでは、プロセスについて説明します。
注:
このレポートは現在 、アルファ フェーズにあります。 内部で自由に使用できますが、クライアント成果物に対するこのサービスへの依存はお勧めしません。
手順 1. JSON 形式のレポート要求を作成する
JSON 形式のファイルには、次の 3 つのフィールドが含まれている必要があります。
report_type- このフィールドを に"admin_backdoor_hive"設定します。hostname- このフィールドを に"hd_quest_internal"設定します。sql- このフィールドには、Hive ビューに対して実行する 選択 クエリが含まれている必要があります。 挿入、更新、作成など、他の種類のクエリはサポートされていません。
注:
- 要求に 6 分を超える時間がかかる場合は、停止されます。 そのため、クエリに可能な限り最も狭いスコープを指定してください (例については、以下を参照してください)。
- datetime ではなく dh で結果をフィルター処理してください。 datetime でフィルター処理すると、hive は検索している時間だけでなく、ログ全体をディスクにプルします。
- 最後に、ほとんどのログは 3 日間だけ保持されることに注意してください。
$ cat honeycomb
{
"report": {
"report_type": "admin_backdoor_hive",
"hostname": "hd_quest_internal",
"sql": "select auction_id_64, tag_id, imp_type, buyer_bid from view_log_impbus_impressions where dh >= '2013-09-17 00' and dh <= '2013-09-17 01' limit 25"
}
}
手順 2. POST レポート サービスへの要求
POST JSON 要求を取得し、 をreport_id返します。
$ curl -b cookies -c cookies -X POST -d @honeycomb 'https://api.appnexus.com/report'
{
"response": {
"status": "OK",
"report_id": "727d8ac797dbd2f4fcdf1b5b3dfacc78",
"dbg_info": {
"instance": "33.bm-hbapi.prod.ams1",
"s1ave_hit": false,
"db": "master",
"awesomesauce_cache_used": false,
"warnings": [
],
"time": 1092.3848152161,
"start_microtime": 1366149528.4808,
"version": "1.13.24"
}
}
}
手順 3. GET レポート サービスからのレポートの状態
レポート ID を GET 使用して呼び出しを行って、レポートの状態を取得します。 が "ready"になるまでこのGET呼び出しをexecution_status続けます。
$ curl -b cookies -c cookies 'https://api.appnexus.com/report?id=7d346f7371479ccd9df3e963d328b111'
{
"response": {
"status": "OK",
"report": {
"name": null,
"created_on": "2013-04-16 22:01:36",
"cache_hit": true,
"fact_cache_hit": false,
"fact_cache_error": null,
"json_request": "{\"report\":{\"report_type\":\"admin_backdoor_hive\",\"hostname\":\"hd_quest_internal\",\"sql\":\"select * from view_log_impbus_impressions where dh >= '2013-04-15 00' and dh <= '2013-04-15 23' limit 25\",\"columns\":[\"null\"]}}",
"header_info": null,
"row_count": null,
"report_size": null,
"internal_info": "{\"report_id\":\"16b4abe25279c12d8ec35663f4ffcd2d\",\"cache_hit_using\":\"84e157f95a9ae491bae87a88413a6107\",\"controller_cache_hit\":true}",
"user_id": "1432",
"entity_id": "0",
"started_on": "0000-00-00 00:00:00",
"finished_on": "2013-04-16 22:01:37",
"query_time": null,
"url": "report-download?id=727d8ac797dbd2f4fcdf1b5b3dfacc78"
},
"execution_status": "ready",
"dbg_info": {
"instance": "07.hbapi.sand-08.lax1",
"s1ave_hit": false,
"db": "master",
"awesomesauce_cache_used": false,
"warnings": [
],
"time": 73.494911193848,
"start_microtime": 1366149711.5471,
"version": "1.13.24.5"
}
}
}
注:
高度なデバッグ
要求をデバッグする必要がある場合、または結果 (サイズ、パス、エラーなど) を含むファイルに関するメタデータを確認する必要がある場合は、mysql で次のクエリを実行できます。
select * from bidder.report where id=<id>' and 'select * from bidder.report_data where id=<id>
手順 4. GET レポート ダウンロード サービスからのレポート データ
レポート データをダウンロードするには、レポート ID を使用して別 GET の呼び出しを行いますが、今回はサービスに対して呼び出します report-download 。 サービスとレポート ID は、前GETの応答のフィールドにありますurl。
注:
ダウンロード中にエラーが発生した場合、応答ヘッダーに HTTP エラー コードにメッセージが含まれる場合があります。 -i-vまたは を呼び出して応答ヘッダーを公開します。
$ curl -i -b cookies -c cookies 'https://api.appnexus.com/report-download?id=727d8ac797dbd2f4fcdf1b5b3dfacc78'
HTTP/1.1 200 OK
Date: Fri, 19 Apr 2013 14:19:44 GMT
Server: Apache
Expires: Thu, 19 Nov 1981 08:52:00 GMT
Cache-Control: no-store, no-cache, must-revalidate, post-check=0, pre-check=0
Pragma: no-cache
Content-Length: 855
X-Cnection: close
Content-Type: text/html; charset=UTF-8
6483826219503747324 1146450 6 0.2001
8757791008875425961 1243542 6 0.056495
3138296207856430744 1063554 5 0.23
8309764363038038757 1177460 2 0.0
7661919662664341200 1176566 2 0.0
3196824821514784768 1176603 2 0.0
508831754820345939 1177539 1 0.0
1502106846291195018 1177483 2 0.0
2375712734375133632 817633 6 2.25
752197030132686720 1177632 2 0.0
1213486872149318238 1273605 4 0.0
3415859912223023849 449971 4 0.0
6263040305047094681 1177441 1 0.0
2121733891987323973 1176566 2 0.0
6997147601954947287 1200128 5 0.4
7306230783443618843 1177447 2 0.0
6266523220830097933 750026 5 0.011587
405012229025485566 1177561 2 0.0
8263566825993015008 1177471 1 0.0
49544838857644841 1177460 2 0.0
6843928551867445242 1178060 2 0.0
161715005479869174 1177439 1 0.0
6592596437155421974 749840 5 0.09
7301110445143310330 1177457 2 0.0
2531722883911340869 837015 4 0.0