Hilfe?!

Wenn etwas nicht funktioniert, kann es dafür zwei Gründe geben:

• Es gibt einen Bug, bei dessen Behebung wir helfen können, oder
• Sie machen vielleicht etwas nicht ganz richtig – das kann passieren und ist auch nicht schlimm.

Egal, was der Grund für Ihr Problem ist, wir können Ihnen dabei helfen, das Ganze in Ordnung zu bringen, damit Sie wieder glücklich sind.

Über unser Community-Diskussionsforum und Slack steht Ihnen eine starke und hilfreiche Community von Nutzer:innen zur Verfügung, die Ihnen gern dabei helfen, Probleme aller Art zu lösen. Wenn Sie diese Möglichkeit nutzen möchten, empfehlen wir Ihnen, die folgenden Ratschläge zu befolgen.

Wenn Sie für Ihren Dienst Elastic Cloud nutzen, können Sie sich gern an das Support-Team wenden.

Beschreiben Sie Ihr Problem klar und verständlich, damit Ihnen die Community besser helfen kann. Dazu ein paar Tipps:

• Wenn die Antwort oder Lösung nicht dem entspricht, was Sie erwartet haben, sollten Sie uns Ihre Erwartungen wissen lassen, damit wir besser verstehen können, was Sie erreichen möchten.
• Wenn Sie jemandes Anweisungen befolgt haben, egal wer diese verfasst hat, senden Sie uns bitte die URL zu diesen Anweisungen, damit wir Ihren Ansatz prüfen können.
• Machen Sie Angaben zur Version des Elastic Stack-Produkts (oder der Produkte), das Sie verwenden, und zu Ihrem Betriebssystem und/oder Browser.

Am besten ist es, wenn Sie zunächst ein einfaches, aber vollständiges Reproduktionsskript des Problems erstellen, also eine Auflistung der Schritte, die Sie ausgeführt haben, bevor das Problem aufgetreten ist. Wenn Sie die Dev Tools in Kibana nutzen, kopieren Sie bitte auch Ihre API-Anfragen und die Ausgaben darauf. Das gilt in gleicher Form, wenn Sie cURL oder ein CLI verwenden oder json- bzw. yaml-Konfigurationsdateien haben.

Forenbeiträge dürfen eine bestimmte Größe nicht überschreiten. Sie können die oben beschriebene Ausgabe entweder in mehrere Beiträge aufteilen oder gist/pastebin/etc. verwenden und den Link dann in Ihren Beitrag einfügen, damit wir uns die Details ansehen können.

Bitte posten Sie keine Bilder von Textausgaben, z. B. API-Anfragen und -Antworten oder Konfigurationsdateien. Diese können schwer les- und replizierbar sein, sind möglicherweise nicht durchsuchbar und werden unter Umständen auch nicht allen Nutzer:innen angezeigt.

Je vollständiger Ihr Problem reproduzierbar ist, desto klarer wird die Frage, die Sie stellen, und desto einfacher wird es für andere sein, Ihnen zu helfen und schnell eine Lösung zu finden!

In Kibana gibt es im Menü „Dev Tools“ ein praktisches Tool namens Console. Dieses Tool hilft Ihnen, Anfragen an Elasticsearch zu senden. Wenn Sie beispielsweise die Begrüßungsinformationen angezeigt bekommen möchten, reicht es, Folgendes zu senden:

GET /

Die Antwort sieht dann ungefähr so aus:

{
  "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"
}

Ein vollständiges Reproduktionsskript kann einfach in Kibana Console kopiert und dort ausgeführt werden, um Ihr Problem nachzustellen. Ein solches Skript hilft den Leser:innen, Ihr Problem zu verstehen und schnell eine Antwort zu finden.

Öffnen Sie die Kibana Dev Console und reproduzieren Sie Ihr Problem anhand eines sehr einfachen Beispiels. Es ist nicht nötig, den vollständigen Anwendungsfall mit allen Feldern zu reproduzieren. Konzentrieren Sie sich lieber auf das eigentliche Problem.

Hier ein Beispiel für ein Skript, das von allen Community-Mitgliedern ganz einfach in die Kibana Dev Console eingefügt und ausgeführt werden kann:

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

Kopieren Sie Ihr Skript und fügen Sie es in die Diskussion ein. Machen Sie dies auch mit der Antwort, die Sie erhalten, und erklären Sie, was Sie erwarten.

Dazu noch ein paar wichtige Hinweise:

• Es hilft immer, wenn Sie Ihr Mapping in das Beispiel aufnehmen.
• Es kann nützlich sein, alle spezifischen Elasticsearch-Einstellungen, die Sie verwenden, oder die Liste der benötigten Plugins bereitzustellen, falls welche installiert sind.
• Es kann auch helfen, wenn Sie das zurückgegebene JSON-Ergebnis zur Verfügung stellen und mitteilen, welches Ergebnis Sie erwarten. Wenn Sie statt der Kibana Dev Console curl verwenden, achten Sie darauf, an Ihre Anfrage „?pretty=true“ anzuhängen, damit die JSON-Ausgabe korrekt formatiert ist.

Öffnen Sie die Kibana Dev Console und reproduzieren Sie Ihr Problem anhand eines sehr einfachen Beispiels. Es ist nicht nötig, den vollständigen Anwendungsfall mit allen Feldern zu reproduzieren. Konzentrieren Sie sich lieber auf das eigentliche Problem.

Hier ein Beispiel für ein Skript, das von allen Community-Mitgliedern ganz einfach in die Kibana Dev Console eingefügt und ausgeführt werden kann:

Wenn Sie Ihr Problem zu reproduzieren versuchen, ist es immer besser, die neueste Version des Stack zu verwenden, da es sein kann, dass Ihr Problem inzwischen behoben wurde.

Es kann etwas dauern, bis Ihre Frage beantwortet wird – haben Sie Geduld, fragen Sie nicht wiederholt nach und eröffnen Sie nicht mehrere Themen für ein und dieselbe Frage. Denken Sie daran, dass es sich um Community-Foren handelt, sodass nicht immer jemand sofort da ist, der Ihnen kompetent antworten kann. Weitere Informationen dazu finden Sie im Verhaltenskodex der Community und hier besonders im Abschnitt „Seien Sie geduldig“.

Bitte pingen Sie niemanden an, der sich nicht bereits direkt bei Ihrem Thema beteiligt – das hier ist ein Forum und jedes Mitglied ist möglicherweise in der Lage, Ihnen zu helfen. Außerdem ist die Veröffentlichung der Antwort ein großer Gewinn für die nächsten Leser:innen.

Wenn Sie einen Service mit einem SLA mit vorgegebenen Reaktionszeiten bei Fragen benötigen, sollten Sie mit uns über ein Abonnement sprechen.

Wenn Sie nach 2 oder 3 Tagen (Wochenenden nicht mitgerechnet) noch keine Antwort haben, ist es in Ordnung, im eigenen Thread nachzuhaken.