splunk / splunk/docker-splunk

Using checkstate.sh as liveness probe leads to failing HEC connections

Open
#561 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
Python
Stars
549
Forks
277
Avg merge
3d 9h
Merged PRs (30d)
2

Description

We are using docker-splunk in k8s and therefore use checkstate.sh as liveness probe. The problem is that checkstate.sh executes the following to check if Splunk is still running: curl --max-time 30 --fail --insecure $scheme://localhost:8089/

So it checks if splunkd is still running on port 8089, but this is probably the thing that is available until the very last second if Splunk shutting down so Splunk Web, HECs, Receivers,... they are all already gone when this endpoint will still return 200. As long as this returns 200 the LoadBalancer or something like an ingress-nginx will happily send traffic to the endpoint, leading to timeouts and broken connections.

My proposal to fix this would be to apply the following logic in checkstate.sh:

  1. Check if there are HECs and receivers running
  2. If so, assess the liveness of the container based on the response of these ports and not 8089
  3. If not, stay with the current check and see if 8089 is still available

There may even be better ways to achieve this, maybe someone has an idea?

If we agree on a fix I would be happy to create an MR to solve this.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with checkstate.sh and its curl check against localhost:8089. Review how the container exposes HECs and receivers, then determine how their responses should affect liveness while retaining the current 8089 check when none are running. Done means the probe stops routing traffic when those services are unavailable without breaking the existing fallback.

Written by the indexing model from the issue text.

Assessment

Tech stack
docker, kubernetes, shell
Domain
devops, infrastructure
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.