Skip to content

Commit e240749

Browse files
stefnestorbmorelli25kilfoyleshainaraskas
authored
add product diags to 'working with support' (#1921)
πŸ‘‹ howdy, team + @kilfoyle ! Low-level pass at #1725 πŸ™ --------- Co-authored-by: Brandon Morelli <[email protected]> Co-authored-by: David Kilfoyle <[email protected]> Co-authored-by: shainaraskas <[email protected]>
1 parent b12d483 commit e240749

File tree

1 file changed

+39
-5
lines changed

1 file changed

+39
-5
lines changed

β€Žtroubleshoot/index.md

Lines changed: 39 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -57,14 +57,48 @@ If you have an [Elastic subscription](https://www.elastic.co/pricing), you can c
5757
If you contact us by email, use the email address you registered with so we can help you more quickly. If your registered email is a distribution list, you can register a second email address with us. Just open a case to let us know the name and email address you want to add.
5858
:::
5959

60+
:::{warning}
61+
All cases opened by email default to a normal severity level. For incidents, open a case through the [Elastic Support Portal](https://support.elastic.co/) and select the [appropriate severity](https://www.elastic.co/support/welcome#what-to-say-in-a-case).
62+
:::
63+
6064
## Working with support [troubleshoot-work-with-support]
6165

62-
Try these tips when opening a support case:
66+
When you open a support case:
67+
68+
* Describe the problem with context about the situation and its business severity, as described in [What should I say in my case?](https://www.elastic.co/support/welcome#what-to-say-in-a-case).
69+
70+
* If an error message was encountered, include the full error message and the timezone-designated timestamp of when the problem occurred.
71+
72+
* If the problem is UI-related and can't be replicated using API calls, pull a [browser network log](https://www.elastic.co/blog/generating-browser-har-file-kibana-troubleshooting).
73+
74+
* Upload the related product's diagnostics and debug logs:
75+
76+
* If hosting on {{serverless-full}} or {{ech}}, Support can pull diagnostics on your behalf as long as you include resource IDs:
77+
78+
* {{serverless-full}} Project ID or {{kib}} URL
79+
* {{ech}} Deployment ID or {{kib}} URL
6380

64-
* Include the deployment ID that you want help with, especially if you have several deployments.
81+
* If hosting on {{ece}} or {{eck}}:
6582

66-
You can find the deployment ID on the overview page for your cluster in the {{ecloud}} Console.
83+
* {{ece}} [diagnostic](/troubleshoot/deployments/cloud-enterprise/run-ece-diagnostics-tool.md) flagging `--deployments` as applicable
84+
* {{eck}} [diagnostic](/troubleshoot/deployments/cloud-on-k8s/run-eck-diagnostics.md)
6785

68-
* Describe the problem. Include any relevant details, including error messages you encountered, dates and times when the problem occurred, or anything else you think might be helpful.
86+
* If self-hosting:
87+
88+
* {{es}} [diagnostic](/troubleshoot/elasticsearch/diagnostic.md) and [debug logs](/deploy-manage/monitor/logging-configuration/update-elasticsearch-logging-levels.md)
89+
* {{kib}} and {{fleet}} [diagnostic](/troubleshoot/kibana/capturing-diagnostics.md) and [debug logs](/deploy-manage/monitor/logging-configuration/kibana-log-levels.md)
90+
91+
* Ingest tools:
92+
93+
* {{ls}} [diagnostic](/troubleshoot/ingest/logstash/diagnostic.md) and [debug logs](logstash://reference/logging.md)
94+
* {{agent}} [diagnostic](https://www.elastic.co/docs/troubleshoot/ingest/fleet/common-problems#trb-collect-agent-diagnostics) and [debug logs](https://www.elastic.co/docs/reference/fleet/monitor-elastic-agent#change-logging-level)
95+
96+
97+
:::{tip}
98+
The {{es}} cluster maintains an advanced task management system, while other products use a simpler polling mechanism. Because of this, some issues appear only in their start-up debug logs. Later logs may note only that the subprocess has stopped or that it has not changed state from an earlier error.
99+
:::
100+
101+
:::{warning}
102+
Diagnostics and logs mainly emit product metadata and settings, but they may expose sensitive data which needs to be redacted before being shared outside of your organization. Refer to each product's diagnostics page for information on sanitizing output.
103+
:::
69104

70-
* Upload any pertinent files.

0 commit comments

Comments
Β (0)