network-connection-check

README

Network Connection Check

The Network Connection Check checks for successful/unsuccessful connections to network targets (via tcp or udp). Each check connect to one network target. Default KHCheck configurations applied are:

• successfulNetworkConnectionCheck.yaml
  • Target: tcp://github.com:443
  • Target should be reachable: false
  • Check Name: kuberhealthy-github-reachable
• failedNetworkConnectionCheck.yaml
  • Hostname: tcp://169.254.169.254:80
  • Target should be unreachable: true
  • Check Name: kuberhealthy-metadata-unreachable

The check runs every 30 minutes (spec.runInterval), with a check timeout set to 10 minutes (spec.timeout). The CONNECTION_TIMEOUT environment variable is used to define the timeout for the performed network connection. If CONNECTION_TIMEOUT isn't set, 20s will be used as default timeout value.

If the check does not complete within the given timeout and target should be reachable it will report a timeout error on the status page. If the check does not complete within the given timeout and target should not be reachable it will report a success on the status page.

To verify connections, apply another KHCheck configuration file with a different CONNECTION_TARGET environment variable. CONNECTION_TARGET accepts tcp:// or udp:// (e.g. udp://10.16.12.10:9000 or tcp://10.16.12.11:8080)

Network Connection Check Kube Spec:

apiVersion: comcast.github.io/v1
kind: KuberhealthyCheck
metadata:
  name: kuberhealthy-github-reachable
  namespace: kuberhealthy
spec:
  runInterval: 30m
  timeout: 10m
  podSpec:
    containers:
      - env:
          - name: CONNECTION_TARGET
            value: "tcp://github.com:443"
        image: kuberhealthy/network-connection-check:v0.1.3
        name: kuberhealthy-github-reachable

Documentation

Overview

Package dnsStatus implements a DNS checker for Kuberhealthy It verifies that local DNS and external DNS are functioning correctly