From a93884483366c0c081a3c6bc3e9f552bfd402e6b Mon Sep 17 00:00:00 2001 From: David Kilfoyle <41695641+kilfoyle@users.noreply.github.com> Date: Mon, 15 Jan 2024 09:26:17 -0500 Subject: [PATCH] Add troubleshooting for TSDB runtime issue (#809) (cherry picked from commit d812925627f86e8f2b712a395c660d14636223c6) --- .../troubleshooting/troubleshooting.asciidoc | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/docs/en/ingest-management/troubleshooting/troubleshooting.asciidoc b/docs/en/ingest-management/troubleshooting/troubleshooting.asciidoc index 6f39d60d8..2b485beac 100644 --- a/docs/en/ingest-management/troubleshooting/troubleshooting.asciidoc +++ b/docs/en/ingest-management/troubleshooting/troubleshooting.asciidoc @@ -22,6 +22,16 @@ Have a question? Read our <>, or contact us in the Running {agent} standalone? Also refer to <>. +[discrete] +[[tsdb-illegal-argument]] +== illegal_argument_exception when TSDB is enabled + +When you use an {agent} integration in which TSDB (Time Series Database) is enabled, you may encounter an `illegal_argument_exception` error in the {fleet} UI. + +This can occur if you have a component template defined that includes a `_source` attribute, which conflicts with the `_source: syntethic` setting used when TSDB is enabled. + +For details about the error and how to resolve it, refer to the section `Runtime fields cannot be used in TSDB indices` in the Innovation Hub article link:https://support.elastic.dev/knowledge/view/9363b9fd[TSDB enabled integrations for {agent}]. + [discrete] [[agents-in-cloud-stuck-at-updating]] == {agent}s hosted on {ecloud} are stuck in `Updating` or `Offline` @@ -648,4 +658,3 @@ curl -u elastic: --request POST \ == Air-gapped {agent} upgrade can fail due to an inaccessible PGP key In versions 8.9 and above, an {agent} upgrade may fail when the upgrader can't access a PGP key required to verify the binary signature. For details and a workaround, refer to the link:https://www.elastic.co/guide/en/fleet/8.9/release-notes-8.9.0.html#known-issue-3375[PGP key download fails in an air-gapped environment] known issue in the version 8.9.0 Release Notes or to the link:https://github.com/elastic/elastic-agent/blob/main/docs/pgp-workaround.md[workaround documentation] in the elastic-agent GitHub repository. -