도움이 필요하신가요?!

무엇인가 제대로 작동하지 않는 경우, 다음과 같은 두 가지 가능성이 있습니다.

  • 버그가 있습니다 - 이 버그 수정은 저희가 도와드릴 수 있습니다, 또는
  • 여러분이 뭔가 잘못된 일을 하고 있을 수 있습니다 - 그래도 괜찮습니다!

어느 쪽이든, 만족스럽게 문제를 해결할 수 있도록 도와드릴 수 있습니다.

Elastic 커뮤니티 토론 포럼Slack 인스턴스에는 강력하고 유용한 사용자 커뮤니티가 있으며, 이 커뮤니티는 문제 해결을 위해 기꺼이 도와 드립니다. 이를 위해, 다음과 같은 지침 몇 가지를 제안해 드립니다.

Elastic Cloud를 사용하여 서비스를 실행 중인 경우, 언제든지 지원 팀에 문의하세요.

이해 가능, 재현 가능

문제에 대한 명확한 설명은 커뮤니티가 여러분을 도와드리는 데 도움이 됩니다. 다음은 몇 가지 팁입니다.

  • 만약 여러분이 기대하고 계시는 것과 다른 종류의 도움을 받게 되는 경우, 여러분이 기대했던 바를 정확히 알려주시면 여러분이 성취하려고 하는 것을 저희가 이해하는 데 도움이 됩니다.
  • 누가 작성한 지침이든 해당 지침을 준수하신 경우, 그 URL 링크를 알려주시면 여러분이 어떤 접근 방식을 취하셨는지를 저희가 확인할 수 있습니다.
  • 운영 체제 및/또는 브라우저와 함께 사용 중이신 Elastic Stack 제품 버전 등과 같은 정보를 포함해 주세요.

시작하는 가장 좋은 방법은 간단하지만 완전하게 문제를 재현할 수 있는 스크립트를 만드는 것입니다. Kibana에서 개발자 도구를 사용 중이신 경우, 만들고 계시는 API 요청과 출력을 복사하세요. cURL이나 CLI를 사용 중이시거나 json 또는 yaml 구성 파일이 있는 경우에도 동일한 접근 방식이 적용됩니다.

포럼에는 게시물의 크기에 대한 제한이 있습니다. 위의 출력을 여러 게시물로 분할하거나 gist/pastebin/ 등을 사용한 다음 자세한 내용을 볼 수 있도록 게시물에 링크할 수 있습니다.

API 요청 및 응답 또는 구성 파일 등과 같은 텍스트 출력의 사진은 게시하지 마세요. 이러한 정보는 읽기 및 복제가 어렵고, 검색이 불가능하며, 모든 사용자에게 표시되지 않을 수 있습니다.

여러분이 제공해 주신 재현 단계가 더 완전할수록, 질문하시는 내용이 더 명확해지고, 다른 사람들이 더 쉽게 여러분을 도와 더 빨리 해결책을 찾게 됩니다!

재현이란 무엇인가?

Kibana에는 개발자 도구 메뉴에서 사용할 수 있는 콘솔이라는 편리한 도구가 있습니다. 이 콘솔은 Elasticsearch에 요청을 보내는 데 도움이 됩니다. 예를 들어, 다음을 전송하기만 하면 시작 정보를 표시할 수 있습니다.

GET /

그러면 다음과 같은 결과가 반환됩니다.

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

전체 재현 스크립트는 누구나 복사하여 Kibana 콘솔에 붙여넣고 여러분의 문제를 재현하기 위해 실행할 수 있습니다. 이렇게 독자들이 여러분의 문제를 이해하고 재현하여 더 빠른 반응을 얻을 수 있도록 도와줍니다.

재현 스크립트는 어떻게 생성하는가?

Kibana 개발자 콘솔을 열고 아주 간단한 예제를 사용하여 여러분이 당면하고 있는 문제를 재현하세요. 모든 필드를 사용하여 전체 사용 사례를 다시 만들 필요가 없습니다. 그냥 실제 문제에만 집중하시면 됩니다.

예를 들어, 이 스크립트는 모든 커뮤니티 구성원이 Kibana 개발자 콘솔에서 쉽게 붙여넣고 실행할 수 있습니다.

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

토론에서 그리고 여러분이 받고 있는 응답에서 여러분의 스크립트를 복사하여 붙여넣고 여러분이 무엇을 기대하고 있는지를 설명하세요.

참고:

  • 매핑을 예제에 포함하는 것이 항상 유용합니다.
  • 사용 중이신 특정한 Elasticsearch 설정이나 필요한 플러그인 목록(설치한 경우)을 공유하는 것이 유용할 수 있습니다.
  • 여러분이 얻고 있는 JSON 결과와 여러분의 예상 결과를 공유하는 것도 유용할 수 있습니다. Kibana 개발자 콘솔 대신 curl을 사용하고 계시는 경우, 올바른 형식의 JSON 출력을 사용하려면 요청에 ?pretty=true를 추가해야 합니다.

문제를 진단하는 데 유용한 API

Kibana 개발자 콘솔을 열고 아주 간단한 예제를 사용하여 여러분이 당면하고 있는 문제를 재현하세요. 모든 필드를 사용하여 전체 사용 사례를 다시 만들 필요가 없습니다. 그냥 실제 문제에만 집중하시면 됩니다.

예를 들어, 이 스크립트는 모든 커뮤니티 구성원이 Kibana 개발자 콘솔에서 쉽게 붙여넣고 실행할 수 있습니다.

GET /클러스터 정보
GET /_cat/health?v가상 형식의 클러스터 상태
GET /_cat/nodes?v가상 형식의 클러스터 노드
GET /_cat/indices?v가상 형식의 클러스터 인덱스
GET /_cat/shards?v가상 형식의 클러스터 샤드
GET /INDEX/_settingsINDEX 설정 가져오기
GET /INDEX/_mappingINDEX 매핑 가져오기

문제를 재현하려고 할 때는, 그 사이에 여러분의 문제가 이미 해결되었을 수 있으므로 항상 최신 버전의 스택을 사용하는 것이 좋습니다.

인내심을 가지세요!

질문에 대한 응답을 기다릴 때는 응답을 요청하는 핑을 여러 번 보내거나 동일한 질문에 대해 여러 주제를 열지 않도록 인내심을 가지세요. 커뮤니티 포럼이기 때문에, 누군가가 여러분의 질문에 답변하는 데 시간이 걸릴 수 있습니다. 자세한 내용은 커뮤니티 행동 규범, 구체적으로 "인내(Be patient)" 섹션을 참조하세요.

여러분의 주제에 이미 포함되지 않은 누군가에게 직접 핑을 보내지 마세요. 이것은 포럼이므로 참여하는 사람은 누구나 여러분을 지원할 수 있습니다. 또한, 답변을 공개적으로 공유하면 다음 독자들에게 큰 자산이 됩니다.

질문에 대한 응답 시간을 보장하는 SLA를 갖춘 서비스가 필요한 경우, 구독에 대해 Elastic에 문의하시는 것도 좋습니다.

답변이 없는 경우, 2~3일(주말 제외) 이후에 여러분이 해당 스레드에 답변하셔도 괜찮습니다.