Elasticsearch:Use the Kibana plugin to query or tag data

Notes d'utilisation

• Les plugins Kibana sont pris en charge uniquement sur les versions 6.3 et 6.7 d'Alibaba Cloud Elasticsearch.

• Avant d'installer un plugin, assurez-vous que votre nœud Kibana dispose d'au moins 2 vCPU et de 4 Go de mémoire. Si votre nœud Kibana ne répond pas à cette exigence, mettez-le à niveau. Pour plus d'informations, consultez la rubrique Mettre à niveau la configuration du cluster.

• Vous ne pouvez pas installer de plugins Kibana personnalisés.

Procédure

1. Connectez-vous à la console Alibaba Cloud Elasticsearch.

2. Dans le volet de navigation de gauche, cliquez sur Elasticsearch Clusters.

3. Dans la barre de navigation supérieure, sélectionnez un groupe de ressources et une région.

4. Sur la page Elasticsearch Clusters, cliquez sur l'ID du cluster cible.

5. Dans le volet de navigation de gauche, cliquez sur Data Visualization.

6. Dans la section Kibana, cliquez sur Modify Configuration.

7. Dans la section Plug-in Configuration, localisez le plugin à installer et cliquez sur Install dans la colonne Actions.

   Important

   L'installation d'un plugin déclenche le redémarrage du nœud Kibana. Pendant le redémarrage, les services Kibana sont indisponibles. Nous vous recommandons d'effectuer cette opération pendant les heures creuses.

8. Dans la boîte de dialogue Installation Prompt, cliquez sur OK.

   Une fois le nœud redémarré, le plugin est installé. Son statut passe à Installed.

Informations générales

Query DSL est un framework Java open source destiné à la construction de requêtes SQL typées de manière sûre. Il permet de formuler des requêtes via une API plutôt que par concaténation de chaînes de caractères. Query DSL prend en charge diverses plateformes, notamment JPA, JDO, SQL, Java Collections, RDF, Lucene et Hibernate Search.

Elasticsearch met à disposition un DSL complet basé sur JSON pour définir les requêtes. Le DSL de requête se compose d'une série d'expressions de requête abstraites. Certaines requêtes peuvent contenir d'autres requêtes (comme bool), certaines peuvent inclure des filtres (comme constant_score), et d'autres peuvent combiner requêtes et filtres (comme filtered). Vous pouvez associer n'importe quelle expression de requête et filtre pris en charge par Elasticsearch pour élaborer des requêtes complexes. Toutefois, la rédaction d'instructions DSL est sujette aux erreurs et nécessite des connaissances spécialisées. BSearch-QueryBuilder aide les utilisateurs peu familiarisés avec le DSL d'Elasticsearch à générer rapidement des instructions DSL.

Le plugin BSearch-QueryBuilder présente les caractéristiques suivantes :

• Facilité d'utilisation : BSearch-QueryBuilder offre une interface visuelle par pointage et clic pour construire des requêtes DSL Elasticsearch. Vous pouvez effectuer des requêtes de données personnalisées sans coder, ce qui réduit la courbe d'apprentissage liée au DSL complexe. Il aide également les développeurs à rédiger ou valider des instructions DSL.

• Praticité et rapidité : Vous pouvez enregistrer des conditions de requête complexes dans Kibana afin d'éviter de les recréer.

• Légèreté : Le plugin occupe environ 14 Mo d'espace disque et ne s'exécute pas de manière persistante en mémoire. Il n'affecte pas le fonctionnement normal de Kibana et d'Elasticsearch.

• Sécurité et fiabilité : Le plugin BSearch-QueryBuilder ne modifie, ne stocke ni ne transfère vos données. Son code source a passé l'audit de sécurité d'Alibaba Cloud.

Procédure

1. Connectez-vous à la console Kibana de votre cluster Alibaba Cloud Elasticsearch.

   Pour plus d'informations, consultez la rubrique Se connecter à la console Kibana.

2. Facultatif : Dans le volet de navigation de gauche, cliquez sur Management et créez un modèle d'index.

   Important

   Si vous avez déjà créé un modèle d'index, ignorez cette étape.

   1. Sur la page Management, cliquez sur Index Patterns dans la section Kibana.

   2. Sur la page Create index pattern, saisissez un nom de modèle d'index. Le nom doit correspondre à l'index que vous souhaitez interroger.

   3. Cliquez sur Next step.

      Sur la page Create index pattern, saisissez product_info dans le champ Index pattern. Un message indique qu'un index correspond.

   4. Cliquez sur Create index pattern.

3. Dans le volet de navigation de gauche, cliquez sur Discover.

4. Sur la page Discover, dans le coin supérieur droit, cliquez sur Query.

5. Ajoutez des conditions de requête et de filtrage, puis cliquez sur Submit.

   • Cliquez sur l'icône pour ajouter une condition de requête.

   • Cliquez sur l'icône pour ajouter une sous-condition de filtrage à la requête.

   • Cliquez sur l'icône pour supprimer une condition de requête ou de filtrage.

   BSearch-QueryBuilder prend en charge divers types de requêtes, tels que les requêtes avec caractères génériques, les requêtes multi-conditions et les requêtes avec plages horaires personnalisées. Les exemples suivants illustrent la réalisation de ces requêtes :

   • Requête avec caractère générique

     L'exemple suivant montre une recherche floue sur le champ Email. Le champ Email doit correspondre de manière floue à iga. Dans les conditions de filtrage, définissez le champ sur email, sélectionnez Wildcard comme type de correspondance, saisissez *iga* comme valeur de correspondance, puis cliquez sur Submit pour exécuter la requête.

     La requête renvoie tous les enregistrements dont l'e-mail contient iga, tels que abigail@salazar-family.zzz et abigail@banks-family.zzz. Les résultats affichent également des champs tels que customer_first_name, customer_gender et taxful_total_price.

   • Requête multi-conditions

     Les conditions de requête de l'exemple suivant spécifient que l'index doit être tryme_book et qu'un filtre doit être appliqué au champ Type. Le type doit être University Teaching Aids, Math , Teaching Chinese to Speakers of Other Languages ou University Textbooks. Dans Query Builder, sélectionnez l'index tryme_book et choisissez Match comme type de correspondance. Ajoutez un groupe logique OR contenant quatre conditions de correspondance pour le champ type avec les valeurs University Teaching Aids, Mathematics, Teaching Chinese to Speakers of Other Languages et University Textbooks. Cliquez sur submit pour envoyer la requête.

     La requête renvoie plusieurs documents de livre correspondants. Chaque enregistrement affiche des champs tels que author, price, publish, name et info au format JSON.

   • Requête avec plage horaire personnalisée

     Vous pouvez filtrer par champs temporels. Cet exemple montre comment filtrer le champ utc_time pour interroger des données dans la plage [now-240d, now]. Définissez le champ de filtre sur utc_time, sélectionnez In the last comme type de condition, saisissez 240 jours comme valeur, puis cliquez sur Submit.

     La requête renvoie tous les enregistrements de données correspondant à la plage horaire spécifiée (les 240 derniers jours).

Étiqueter des données à l'aide de bsearch_label

bsearch_label est un plugin d'étiquetage de données exclusivement frontal qui permet d'étiqueter visuellement les données sans rédiger d'instructions DSL. L'étiquetage des données permet d'attribuer une valeur spéciale à un champ ou d'ajouter un nouveau champ avec une valeur spécifique. Vous pouvez ensuite utiliser les étiquettes pour l'agrégation, la classification, l'analyse statistique ou le filtrage rapide.

Procédure

1. Connectez-vous à la console Kibana de votre cluster Alibaba Cloud Elasticsearch cible. Pour plus d'informations, consultez la rubrique Se connecter à un cluster via Kibana.

2. Facultatif : Dans le volet de navigation de gauche, cliquez sur Management et créez un modèle d'index. Si vous avez déjà créé un modèle d'index, ignorez cette étape.

   1. Sur la page Management, cliquez sur Index Patterns dans la section Kibana.

   2. Sur la page Create index pattern, saisissez un nom de modèle d'index. Le nom doit correspondre à l'index que vous souhaitez interroger.

   3. Cliquez sur Next step.

   4. Cliquez sur Create index pattern.

3. Dans le volet de navigation de gauche, cliquez sur Discover.

4. Sur la page Discover, dans le coin supérieur droit, cliquez sur Label.

   Le bouton Label n'apparaît qu'après l'installation du plugin bsearch_label.

5. Étiquetez vos données en utilisant l'une des méthodes suivantes.