¿Ayuda?

Si algo no funciona, hay dos posibilidades:

• Hay un error, que podemos ayudar a resolver o
• es posible que estés haciendo algo mal, ¡y está bien!

En cualquier caso, podemos ayudarte a solucionarlo y a que vuelvas a ser feliz.

Hay una comunidad sólida y útil de usuarios en nuestro foro de debate de la comunidad e instancia de Slack; estarán encantados de ayudarte a resolver cualquier problema. Para ello, estas son algunas pautas que sugerimos.

Si ejecutas tu servicio con Elastic Cloud, no dudes en contactarte con el equipo de soporte.

Una explicación clara del problema ayuda a la comunidad para que pueda ayudarte. Estos son algunos consejos:

• Si esperas una cosa, pero obtienes otra, decirnos qué esperabas realmente nos ayuda a comprender lo que intentas lograr.
• Si seguiste instrucciones, independientemente de quién las haya escrito, envíanos el enlace a la URL para poder validar tu enfoque.
• Incluye información como la versión de los productos del Elastic Stack que estás usando, además de los detalles del sistema operativo o navegador.

La mejor forma de comenzar es crear un script de recreación simple y completo del problema. Si usas herramientas de desarrollo en Kibana, copia las solicitudes de API que estás haciendo y todas las salidas. El mismo enfoque aplica si usas cURL o una CLI, o si tienes archivos de configuración json o yaml.

Los foros tienen un límite respecto a la longitud permitida para una publicación. Puedes dividir la salida anterior en varias publicaciones o usar gist/pastebin/etc. e incluir un enlace en tu publicación para que podamos ver los detalles.

No publiques imágenes de las salidas de texto, como solicitudes de API y respuestas o archivos de configuración. Pueden ser difíciles de leer y replicar, no se puede buscar en ellos, y es posible que no se muestren a todos los usuarios.

Cuanto más completa sea tu reproducción, más clara será la pregunta que hagas y más fácil será para los demás ayudarte y encontrar una solución más rápido.

Kibana tiene una herramienta útil llamada Console, disponible en el menú de herramientas de desarrollo. Ayuda a enviar solicitudes a Elasticsearch. Por ejemplo, puedes mostrar la información de bienvenida con solo enviar lo siguiente:

GET /

Esto devolverá algo así:

{
  "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 reproducción completo es algo que todos pueden copiar y pegar en Kibana Console y ejecutar para reproducir tu problema. Ayuda a los lectores a comprender y reproducir tu problema, y a obtener una respuesta más rápido.

Abre la consola de desarrollo de Kibana y reproduce el problema que estás viendo con un ejemplo muy simple. No necesitas recrear tu caso de uso completo con todos los campos. Solo enfócate en el problema real.

Por ejemplo, este script es fácil de pegar y ejecutar para cualquier miembro de la comunidad desde la consola de desarrollo de Kibana:

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

Copia/pega tu script en el debate, además de la respuesta que obtienes, y explica qué es lo que esperas.

Ten en cuenta lo siguiente:

• Siempre es útil incluir tu mapeo en el ejemplo.
• Podría ser útil compartir cualquier configuración específica de Elasticsearch que uses o la lista de los plugins necesarios, si instalaste alguno.
• Podría ser útil compartir también el resultado de JSON que obtienes y cuál sería tu resultado esperado. Si usas curl en lugar de la consola de desarrollo de Kibana, asegúrate de agregar ?pretty=true en tu solicitud para obtener una salida JSON con formato correcto.

Abre la consola de desarrollo de Kibana y reproduce el problema que estás viendo con un ejemplo muy simple. No necesitas recrear tu caso de uso completo con todos los campos. Solo enfócate en el problema real.

Por ejemplo, este script es fácil de pegar y ejecutar para cualquier miembro de la comunidad desde la consola de desarrollo de Kibana:

Al intentar reproducir tu problema, siempre es mejor usar la versión más reciente del stack, dado que es posible que el problema se haya solucionado.

Ten paciencia y aguarda respuestas a tu pregunta, evita hacer pings para solicitar respuesta de forma reiterada o abrir varios temas con la misma pregunta. Dado que es un foro de la comunidad, puede llevar un poco de tiempo para que alguien responda tu pregunta. Para obtener más información, consulta el Código de conducta de la comunidad, en particular la sección "Sé paciente".

Evita hacer ping a personas que no estén en tu tema directamente; esto es un foro y cualquiera que forme parte posiblemente pueda asistirte. Además, compartir la respuesta de forma pública se convierte en un gran activo para los futuros lectores.

Si necesitas un servicio con un SLA que abarque tiempos de respuesta a preguntas, quizá quieras considerar hablar con nosotros respecto a una suscripción.

Está bien responder en tu propio hilo después de 2 o 3 días (sin incluir fines de semana) si no recibiste respuesta.