> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwairy.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Akamai DataStream 2

> Configurez une destination HTTPS personnalisée Akamai DataStream 2 pour Analytics des crawlers.

Utilisez Akamai DataStream 2 pour envoyer un jeu de données de requêtes JSON minimal à Analytics des crawlers via une destination HTTPS personnalisée.

## Avant de commencer

Il vous faut :

* Akamai DataStream 2 pour la propriété cible ;
* l’autorisation de modifier la journalisation dans Property Manager et d’activer un stream ;
* un accès à **Measure > Analytics des crawlers > Paramètres** ;
* un endroit sûr pour conserver le secret du connecteur, affiché une seule fois.

## Créer et protéger la clé

1. Dans les paramètres d’Analytics des crawlers, sélectionnez **Akamai**.
2. Sélectionnez **Créer une clé**.
3. Saisissez un nom et le fuseau horaire IANA utilisé pour les instantanés quotidiens.
4. Copiez le secret lorsqu’il apparaît. Il ne pourra plus être affiché.
5. Enregistrez-le comme mot de passe d’authentification Basic de la destination HTTPS personnalisée.

Pour renouveler la clé, créez une clé de remplacement, mettez à jour et activez la destination, confirmez la livraison, puis supprimez l’ancienne clé. Une intégration peut avoir jusqu’à cinq clés actives.

## Configurer le stream

1. Dans Akamai Control Center, créez ou modifiez un stream DataStream 2 pour la propriété cible.

2. Incluez exactement ces champs de requête :

   ```text theme={null}
   statusCode
   reqTimeSec
   reqHost
   reqMethod
   reqPath
   UA
   ```

3. Sélectionnez **JSON** comme format de log.

4. Dans Property Manager, activez **Log Request Details** et **Log User-Agent Header** pour que `UA` soit renseigné.

5. Définissez la fréquence d’envoi sur 60 secondes ou plus.

6. Choisissez une destination **Custom HTTPS** et définissez :

   | Réglage | Valeur |
   | - | - |
   | Endpoint URL | `https://www.qwairy.co/api/v1/logs/akamai` |
   | Content type | `application/json` |
   | Authentication | Basic |
   | Username | `qwairy` |
   | Password | Le secret du connecteur Qwairy |

7. Si la propriété peut filtrer les user agents de crawlers d’IA connus avant le streaming, appliquez cette condition. Sinon, gardez un jeu de données minimal et laissez Qwairy écarter les lignes non reconnues.

8. Vérifiez puis activez le stream.

Consultez le [guide des destinations HTTPS personnalisées d’Akamai](https://techdocs.akamai.com/datastream2/v2/docs/stream-custom-https) pour la procédure actuelle du fournisseur.

## Tester la livraison

Utilisez la validation de destination d’Akamai ou un stream de test pour vérifier les réglages HTTPS et d’authentification Basic. Un payload de validation ne contient pas forcément d’enregistrement de crawler accepté.

Après l’activation, demandez un chemin sans risque sur le nom d’hôte suivi avec un User-Agent de crawler reconnu :

```bash theme={null}
curl --head --user-agent "GPTBot/1.0" "https://www.example.com/docs/crawler-check"
```

Vérifiez l’état de livraison de DataStream. Qwairy fait quitter l’état en attente au connecteur dès qu’une ligne de crawler valide atteint le pipeline d’agrégation.

## Limites, échantillonnage et coût

* Qwairy accepte des livraisons Akamai jusqu’à 4 000 000 octets. DataStream peut découper des fichiers plus volumineux en plusieurs livraisons.
* Gardez une fréquence d’envoi de 60 secondes ou plus pour ce connecteur.
* Un échantillonnage DataStream inférieur à 100 %, ou une règle Property Manager qui exclut des requêtes, rend les totaux de Qwairy partiels pour ce périmètre.
* La liste minimale de champs exclut l’adresse du client, la chaîne de requête, les cookies et le référent.
* La livraison DataStream et le trafic vers la destination peuvent être facturés par Akamai. Les plafonds quotidiens partagés de Qwairy s’appliquent aussi.

## Dépannage

* **La validation de la destination échoue** : vérifiez HTTPS, `application/json`, l’authentification Basic, le nom d’utilisateur `qwairy` et le secret actuel du connecteur.
* **Qwairy reste en attente** : vérifiez que le stream est actif, que la fréquence d’envoi est prise en charge et que `UA`, `reqHost`, `reqMethod`, `reqPath` et `reqTimeSec` sont renseignés.
* **Les lignes sont acceptées mais pas comptées** : seules les lignes `GET` et `HEAD` récentes pour le nom d’hôte configuré, avec un User-Agent de crawler reconnu, sont agrégées.
* **Les comptes sont inférieurs aux rapports Akamai** : vérifiez le taux d’échantillonnage DataStream, les critères de correspondance de Property Manager, les erreurs d’envoi, les règles d’exclusion de Qwairy et des fenêtres temporelles équivalentes.
* **La livraison est intermittente** : examinez les indicateurs et alertes d’envoi DataStream de la destination avant d’interpréter des périodes manquantes comme des zéros.

## Page associée

* [Analytics des crawlers](/fr/documentation/measure/crawler-analytics)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.