Partager via

Administration Log-Level rapport

Remarque

Ce service est actuellement disponible pour un ensemble limité de clients et d’employés Microsoft uniquement.

Le rapport Administration Log-Level (alias Honeycomb) offre aux administrateurs Xandr un moyen simple et sûr d’exécuter des requêtes sélectionnées pour les données au niveau du journal. Cette page vous guide tout au long du processus.

Remarque

Ce rapport est actuellement en phase alpha . N’hésitez pas à utiliser en interne, mais la dépendance à ce service pour les livrables clients n’est pas recommandée.

Étape 1. Create une demande de rapport au format JSON

Le fichier au format JSON doit inclure trois champs :

  • report_type - Définissez ce champ sur "admin_backdoor_hive".
  • hostname - Définissez ce champ sur "hd_quest_internal".
  • sql - Ce champ doit contenir la requête select que vous souhaitez exécuter sur une vue Hive. Les autres types de requêtes, tels que l’insertion, la mise à jour et la création, ne sont pas pris en charge.

Remarque

  • Si une requête prend plus de 6 minutes, elle est arrêtée. Par conséquent, spécifiez l’étendue la plus étroite possible pour votre requête (voir ci-dessous pour obtenir un exemple).
  • Veillez à filtrer vos résultats par dh et non par datetime ! Si vous filtrez par datetime, Hive extrait l’intégralité du journal sur le disque, et pas seulement l’heure que vous recherchez.
  • Enfin, n’oubliez pas que la plupart des journaux ne sont conservés que pendant 3 jours.
$ 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"
    }
    }

Étape 2. POST la demande au service de rapport

Vous POST la requête JSON et récupérez un 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"
                   }
                   }
                   }

Étape 3. GETle rapport status à partir du service de rapports

Effectuez un GET appel avec l’ID de rapport pour récupérer les status du rapport. Continuez à effectuer cet GET appel jusqu’à ce que soit execution_status"ready".

$ 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"
                   }
                   }
                   }

Remarque

Débogage avancé

Si vous avez besoin de déboguer votre demande ou de voir les métadonnées relatives au fichier contenant vos résultats (taille, chemin d’accès, erreurs, etc.), vous pouvez effectuer la requête suivante dans mysql :

select * from bidder.report where id=<id>' and 'select * from bidder.report_data where id=<id>

Étape 4. GET les données de rapport du service de téléchargement de rapports

Pour télécharger les données du rapport, effectuez un autre GET appel avec l’ID de rapport, mais cette fois au report-download service. Vous trouverez le service et l’ID de rapport dans le url champ de la réponse précédente GET .

Remarque

Si une erreur se produit pendant le téléchargement, l’en-tête de réponse peut inclure un code d’erreur HTTP et un message. Utilisez -i ou -v dans votre appel pour exposer l’en-tête de réponse.

$ 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
  • Last updated on