Aide

Si quelque chose ne fonctionne pas, il y a deux possibilités :

• Il y a un bug, que nous pouvons corriger.
• Vous faites peut-être quelque chose d'incorrect, ce qui n'est pas grave.

Dans les deux cas, nous pouvons vous aider à trouver la solution et à retrouver votre joie de vivre.

Une solide communauté coopérative d'internautes est accessible via notre forum de discussion et notre instance Slack. Elle sera heureuse de vous aider à trouver une solution à vos problèmes. Pour y parvenir, voici quelques instructions à suivre.

Si votre service est exécuté sur Elastic Cloud, n'hésitez pas à contacter l'équipe de support technique.

Une description claire du problème permet à la communauté de vous aider. Pour ce faire, voici quelques conseils :

• Si vous n'obtenez pas ce à quoi vous vous attendez, décrivez précisément vos attentes pour nous aider à comprendre ce que vous essayez de faire.
• Si vous avez suivi des instructions, quelles qu'elles soient, envoyez-nous le lien de l'URL où vous les avez trouvées pour nous permettre de valider votre approche.
• Fournissez diverses informations, notamment la version du ou des produits de la Suite Elastic que vous utilisez, votre système d'exploitation ou votre navigateur.

Pour vous lancer, la meilleure méthode à suivre est de créer un script de recréation simple, mais exhaustif, du problème. Si vous utilisez des outils de développement dans Kibana, copiez les requêtes d'API que vous avez initiées et toutes les données de sortie obtenues. Appliquez la même approche si vous utilisez cURL ou une interface de ligne de commande, ou bien si vous disposez de fichiers de configuration json ou yaml.

Les forums imposent des limites concernant la longueur des publications. Vous pouvez préparer plusieurs publications pour communiquer toutes les données susmentionnées ou utiliser gist/pastebin/etc. et y relier votre publication afin de nous fournir toutes les informations requises.

Merci de ne pas publier d'images provenant des données de sortie au format texte, comme des réponses et des requêtes d'API ou des fichiers de configuration. Il peut être difficile de les lire et de les répliquer, mais aussi impossible d'y mener des recherches et parfois de les afficher pour l'ensemble des internautes.

Plus la reproduction de votre problème est complète, plus la question que vous posez est claire, et plus il est facile pour les autres de vous aider et de trouver rapidement une solution !

Kibana comprend un outil pratique intitulé Console, qui est disponible dans le menu "Dev Tools" (Outils de développement). Il permet d'envoyer des requêtes à Elasticsearch. Par exemple, vous pouvez afficher les informations de bienvenue simplement en envoyant la requête suivante.

GET /

Cette requête permet d'obtenir le résultat suivant.

{
  "name": "instance-0000000003",
  "cluster_name": "b72dca58dc9c4814ab9c68aedee87639",
  "cluster_uuid": "3oq0ZLnWTYqunndjR07okQ",
  "version": {
    "number": "8.8.1",
    "build_flavor": "default",
    "build_type": "docker",
    "build_hash": "f8edfccba429b6477927a7c1ce1bc6729521305e",
    "build_date": "2023-06-05T21:32:25.188464208Z",
    "build_snapshot": false,
    "lucene_version": "9.6.0",
    "minimum_wire_compatibility_version": "7.17.0",
    "minimum_index_compatibility_version": "7.0.0"
  },
  "tagline": "You Know, for Search"
}

Un script de reproduction complète peut être copié et collé par tout le monde dans la console Kibana, puis être exécuté pour reproduire votre problème. Ainsi, les lecteurs comprennent et reproduisent votre problème, puis répondent plus rapidement.

Ouvrez la console de développement de Kibana et reproduisez le problème que vous rencontrez à l'aide d'un exemple très simple. Il n'est pas nécessaire de recréer votre cas d'utilisation complet avec l'ensemble des champs. Il suffit de se concentrer sur le problème en lui-même.

Par exemple, l'ensemble des membres de la communauté peut facilement coller et exécuter le script suivant depuis la console de développement de Kibana.

DELETE index
POST index/_doc
{
  "foo": "bar"
}
GET index/_search
{
  "query": {
    "match": {
      "foo": "bar"
    }
  }
}

Copiez-collez votre script dans la discussion et la réponse obtenue, puis décrivez vos attentes.

Quelques remarques :

• Il est toujours utile d'inclure votre mapping dans l'exemple.
• Il peut être utile de partager tout paramètre Elasticsearch spécifique que vous utilisez ou la liste des plug-ins requis si vous en avez installés.
• Il peut être utile également de partager le résultat JSON que vous obtenez et le résultat que vous aimeriez obtenir. Si vous utilisez cURL au lieu de la console de développement de Kibana, assurez-vous d'ajouter ?pretty=true à votre requête afin d'obtenir des données de sortie JSON bien formatées.

Ouvrez la console de développement de Kibana et reproduisez le problème que vous rencontrez à l'aide d'un exemple très simple. Il n'est pas nécessaire de recréer votre cas d'utilisation complet avec l'ensemble des champs. Il suffit de se concentrer sur le problème en lui-même.

Par exemple, l'ensemble des membres de la communauté peut facilement coller et exécuter le script suivant depuis la console de développement de Kibana.

Quand vous essayez de reproduire votre problème, il est toujours plus judicieux d'utiliser la version la plus récente de la suite, car une solution à votre problème pourrait avoir déjà été trouvée.

Faites preuve de patience pour obtenir les réponses à votre question. Abstenez-vous d'envoyer plusieurs requêtes ping afin de demander une réponse ou de créer plusieurs conversations au sujet de la même question. Notre forum étant communautaire, répondre à votre question peut prendre un certain temps. Pour en savoir plus, lisez le Code de conduite de la communauté, en particulier le paragraphe "Soyez patient.".

Veuillez éviter d'envoyer une requête ping à toutes les personnes qui ne participent pas directement à votre conversation. Sur ce forum, l'ensemble des membres est susceptible de vous aider. Par ailleurs, le partage de la réponse obtenue peut être une formidable ressource pour les prochains lecteurs.

Si vous avez besoin d'un service dans le cadre d'un accord de niveau de service qui régit les temps de réponse aux questions, nous vous conseillons de nous contacter afin de discuter d'un éventuel abonnement.

Si vous n'obtenez aucune réponse, vous pouvez commenter votre propre fil de discussion sous 2 ou 3 jours ouvrés.