Bases de curl et jq

Pour obtenir toutes les tâches actives et formater correctement la sortie, appelez votre compte en utilisant curl, puis dirigez la sortie vers jq.

jq vous permet de filtrer une liste de documents en fonctions des valeurs des zones. Ainsi, il est plus facile d'obtenir tous les documents de réplication, ou les détails d'une seule tâche d'indexation de vue spécifique. La rubrique Référence d'API inclut des informations supplémentaires sur les options.

Voici un exemple d'obtention et de formatage d'une liste de tâches actives :

curl "$SERVICE_URL/_active_tasks" | jq

Surveillance des générations de vue et des index de recherche

Les index de vue sont régénérés à chaque mise à jour d'un document de conception. Dès qu'une de ces vues est mise à jour, toutes les vues du document sont régénérées.

Les index de recherche sont régénérés uniquement lors de la modification de leur fonction d'index correspondante. Dès qu'un index de recherche est régénéré et qu'une modification est apportée à un document de conception incluant des vues, une nouvelle tâche est créée pour chaque réplique et chaque fragment d'un cluster.

Par exemple, si 24 fragments possédant 3 répliques chacun existent et que vous mettez à jour deux index de recherche, alors 24 x 3 x 2 = 144 tâches s'exécutent.

Pour trouver toutes les tâches d'indexation de vue, dirigez la sortie curl vers jq, et laissez ce dernier filtrer les documents dans le tableau en fonction de leur zone de type. Il existe une commande correspondante pour les tâches d'indexation de recherche.

Dans chaque cas, les résultats de la recherche d'une liste de tâches d'indexation sont une liste d'objets JSON : Une pour chacune des tâches actives trouvées.

Voici un exemple de recherche de toutes les tâches d'indexation de vue qui filtre le type indexer :

curl -s "$SERVICE_URL/_active_tasks" | jq '.[] | select(.type=="indexer")'

Voici un exemple de recherche de toutes les tâches d'indexation de recherche qui filtre le type search_indexer :

curl -s "$SERVICE_URL/_active_tasks" | jq '.[] | select(.type=="search_indexer")'

Voici un exemple de résultat suite à la recherche de tâches d'indexation de vue :

{
    "total_changes": 6435,
    "started_on": 1371118332,
    "user": "username",
    "updated_on": 1371118334,
    "type": "indexer",
    "node": "dbcore@db6.meritage.cloudant.net",
    "pid": "<0.16366.6103>",
    "changes_done": 364,
    "database": "shards/40000000-7fffffff/username/database",
    "design_document": "_design/ngrams"
}

Estimation de la durée d'exécution d'une tâche

Pour estimer la durée d'exécution de la tâche d'indexation, surveillez le nombre d'éléments changes_done et comparez cette valeur à total_changes. Par exemple, si changes_done est incrémenté de 250 par seconde et que total_changes a la valeur 1 000 000, il est attendu que l'exécution dure 1 000 000 / 250 = 4 000 secondes, soit environ 66 minutes.

Les estimations de la durée d'exécution d'une tâche d'indexation ne peuvent pas être exactes à 100 %. La durée d'exécution réelle de la tâche dépend des facteurs suivants :

• Durée de traitement de chaque document. Par exemple, une vue pourrait commencer par vérifier le type de document, et créer de nouvelles entrées d'index pour un seul type.
• Taille des documents.
• Charge de travail dans le cluster.

Gardez à l'esprit que ces facteurs peuvent être associés et réduire de manière importante la précision de votre estimation.

Voici un exemple d'extraction de la zone changes_done à l'aide de jq :

curl ... | jq '.[] | select(.type=="search_indexer") | .changes_done'

Surveillance de la réplication

Pour trouver toutes les tâches de réplication, dirigez la sortie curl vers jq, et filtrez les documents dans le tableau en fonction de leur zone de type.

Facilitez la sélection des informations sur un processus de réplication dans la liste de tâches actives en suivant les étapes ci-dessous :

1. Démarrez le processus de réplication en créant un document dans la base de données _replicator.
2. Associez sa zone _id à une valeur connue.

Voici un exemple de recherche de toutes les tâches de réplication qui filtre le type replication :

curl -s "$SERVICE_URL/_active_tasks" | jq '.[] | select(.type=="replication")'

Voici un exemple de recherche d'une tâche de réplication spécifique qui filtre une identité de document connue :

curl ... | jq '.[] | select(.doc_id=="ID")'

Voici un exemple de recherche d'une tâche de réplication spécifique qui filtre une valeur replication_id connue :

curl ... | jq '.[] | select(.replication_id=="ID")'

Voici un exemple de résultat suite à la recherche d'une tâche de réplication :

{
    "started_on": 1371094220,
    "source_seq": "62960-sakdjflksdfjsdlkafjalskdfjlsakfjlasdkjksald",
    "source": "",
    "revisions_checked": 12,
    "continuous": true,
    "doc_id": null,
    "doc_write_failures": 0,
    "docs_read": 12,
    "target": "",
    "type": "replication",
    "updated_on": 1371118477,
    "user": "username",
    "checkpointed_source_seq": "61764-dskfjalsfjsalkfjssadjfhasdfkjhsdkfhsdkf",
    "changes_pending": 1196,
    "pid": "<0.9955.4120>",
    "node": "dbcore@db7.meritage.cloudant.net",
    "docs_written": 12,
    "missing_revisions_found": 12,
    "replication_id": "asfksdlfkjsadkfjsdalkfjas+continuous+create_target"
}

Traitement des incidents générés par des tâches bloquées