Skip to content

docs: Add troubleshooting guide on hive probe errors with kerberos auth #642

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 5 commits into from
Oct 13, 2025
Merged

docs: Add troubleshooting guide on hive probe errors with kerberos auth #642

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
b6f630c
Adding troubleshooting guide on hive probe errors with kerberos auth
Maleware Oct 13, 2025
8aed4aa
Adding newline EOF
Maleware Oct 13, 2025
4aae346
Update docs/modules/hive/pages/troubleshooting/index.adoc
Maleware Oct 13, 2025
67fa8cc
Adding to nav.adoc
Maleware Oct 13, 2025
dbb956d
Merge branch 'fix/docs-for-kerberos-probes' of github.com:stackablete…
Maleware Oct 13, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 27 additions & 0 deletions docs/modules/hive/pages/troubleshooting/index.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
= Troubleshooting

== Probe error 'Thrift Error' while using Kerberos authentication

In Hive 4.0.1 with Kerberos enabled, health checks cause excessive error logs:

[source]
----
ERROR [Metastore-Handler-Pool: Thread-65] server.TThreadPoolServer: Thrift Error occurred during processing of message.
----

This is because the health check doesn’t complete SASL authentication. The error is ignorable, though it can be hidden with the following configuration:

[source,yaml]
----
spec:
metastore:
config:
logging:
containers:
hive:
loggers:
org.apache.thrift.server.TThreadPoolServer:
level: NONE
----

NOTE: This will suppress all logging from TThreadPoolServer, including log events that might be useful for diagnosing issues.
1 change: 1 addition & 0 deletions docs/modules/hive/partials/nav.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -23,3 +23,4 @@
** xref:hive:reference/discovery.adoc[]
** xref:hive:reference/commandline-parameters.adoc[]
** xref:hive:reference/environment-variables.adoc[]
* xref:hive:troubleshooting/index.adoc[]