{"id":36494000,"url":"https://github.com/stevenayers/netkat","last_synced_at":"2026-01-12T01:59:05.432Z","repository":{"id":57605480,"uuid":"184754630","full_name":"stevenayers/netkat","owner":"stevenayers","description":"CLI for troubleshooting kubernetes networking issues","archived":false,"fork":false,"pushed_at":"2023-02-25T00:41:58.000Z","size":39,"stargazers_count":5,"open_issues_count":6,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-10-21T18:44:13.452Z","etag":null,"topics":["aks","aws","azure","eks","gcp","gke","ingress","k8s","kubernetes","networking","troubleshooting"],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/stevenayers.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-05-03T12:50:23.000Z","updated_at":"2021-06-28T06:19:54.000Z","dependencies_parsed_at":"2024-06-20T07:09:50.754Z","dependency_job_id":"56efad8c-1c8b-4022-8296-554bc63aaf74","html_url":"https://github.com/stevenayers/netkat","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/stevenayers/netkat","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stevenayers%2Fnetkat","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stevenayers%2Fnetkat/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stevenayers%2Fnetkat/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stevenayers%2Fnetkat/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stevenayers","download_url":"https://codeload.github.com/stevenayers/netkat/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stevenayers%2Fnetkat/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28331471,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-12T00:36:25.062Z","status":"ssl_error","status_checked_at":"2026-01-12T00:36:15.229Z","response_time":60,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aks","aws","azure","eks","gcp","gke","ingress","k8s","kubernetes","networking","troubleshooting"],"created_at":"2026-01-12T01:59:05.356Z","updated_at":"2026-01-12T01:59:05.413Z","avatar_url":"https://github.com/stevenayers.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# netkat\n[![Build Status](https://travis-ci.org/stevenayers/netkat.svg?branch=master)](https://travis-ci.org/stevenayers/netkat)\n[![codecov.io Code Coverage](https://img.shields.io/codecov/c/github/stevenayers/netkat.svg)](https://codecov.io/github/stevenayers/netkat?branch=master)\n[![Go Report Card](https://goreportcard.com/badge/github.com/stevenayers/netkat)](https://goreportcard.com/report/github.com/stevenayers/netkat)\n[![Release](https://img.shields.io/badge/release-v0.1--alpha-5272B4.svg)](https://github.com/stevenayers/netkat/releases/tag/v0.1-alpha)\n[![GoDoc](https://godoc.org/github.com/stevenayers/netkat?status.svg)](https://godoc.org/github.com/stevenayers/netkat)\n\nCLI for troubleshooting kubernetes networking issues.\n\n## Getting Started\n\nBuild from source:\n* Requires Go 1.13 and dep package management\n```bash\ngit clone git@github.com:stevenayers/netkat.git\ncd netkat\ngo build\ngo build cmd/main.go\nmv ./main /usr/local/bin/netkat\n```\nFor help:\n```bash\n$ netkat -h\n```\n\nExample Usage:\n```bash\n$ netkat grafana.digital.foobar.com -context kops-dev -config ~/.kube/config\n$ netkat pod/grafana-fb86ad62c-f63x9:3000 -context kops-dev -config ~/.kube/config\n```\n```\n=== RUN   CheckKubernetesRouteFromHost\nhost: grafana.digital.foobar.com\nport: 80\npath: /\nip address: 34.89.100.1\n -\u003e ingress: grafana-ingress\n    namespace: metrics\n    path: /\n    ip address: 34.89.100.1\n    -\u003e service: grafana-service\n       namespace: metrics\n       app selector: grafana-app\n       external IP: 34.89.100.1\n       internal IP: 10.44.0.1\n       mapping: http (80) -\u003e 3000\n       -\u003e pod: grafana-fb86ad62c-p72v8\n          namespace: metrics\n          app: grafana-app\n          container: grafana\n          port: 3000\n       -\u003e pod: grafana-fb86ad62c-lg92a\n          namespace: metrics\n          app: grafana-app\n          container: grafana\n          port: 3000\n       -\u003e pod: grafana-fb86ad62c-f63x9\n          namespace: metrics\n          app: grafana-app\n          container: grafana\n          port: 3000\n--- PASS: CheckKubernetesRouteFromHost\n=== PASS: (1/1)\n    --- CheckKubernetesRouteFromHost\n=== FAIL: (0/1)\n```\n\nUnder development, current version will only print out the route when config is setup correctly.\nIncorrect configuration just throws an error and prints out nothing. This needs to be implemented properly.\n\n* Checks ownership of DNS records (to be implemented)\n* Checks external DNS logs (to be implemented)\n* Matches A record against ingress/service\n* Checks service/ingress config\n* Checks ports mappings\n* Checks port is open on pod\n* Checks LB rules on cloud provider side (to be implemented)\n* Checks LoadBalancerSourceRanges (to be implemented)\n\n\n## What Done Looks Like\nEnd-to-end Scenarios\n```\nlocal -\u003e pod_name:port\nlocal -\u003e fqdn:port\nlocal -\u003e http(s)://url/path\nlocal -\u003e http(s)://url:port/path\n```\n\n|**Check Name**|**Description**|**Done**|\n|:-----:|:-----:|:-----:|\nCheckKubernetesRouteFromHost| Takes the host:port info and matches it to ingress or/then service then pod. | x\nCheckStatusPod|  Checks pod status is running| x\nCheckListeningPod|  Portforwards directly to pod and checks connection| x\nCheckKubernetesRouteFromPod| Takes pod:port and maps backwards to a hostname then checks the host configuration. | x\nCheckKubernetesRouteFromInternalHost| Takes the host:port info and matches it to ingress or/then service then pod but for intra-cluster situations. | \nCheckKubernetesRoutePodToPod| Takes pod:port and maps to pod:port| \nCheckStatusNginxIngress| Checks nginx-ingress is healthy.| \nCheckStatusTraefikIngress| Checks traefik ingress is healthy.| \nCheckStatusKubeDns| Checks kube-dns is healthy.| \nCheckSourceRangesIngress| Checks any source range annotations on ingress against originating IP. | \nCheckSourceRangesService| Checks any source range annotations on service against originating IP. | \nCheckInboundRulesLB| Checks originating IP against inbound rules for Load Balancer. | \nCheckInboundRulesLBAzure|  hecks originating IP against inbound rules for Load Balancer. | \nCheckInboundRulesLBAWS| Checks originating IP against inbound rules for Load Balancer. | \nCheckDnsOwnershipGCP| | \nCheckDnsOWnershipAzure| | \nCheckDnsOwnershipAWS| | \nCheckDnsInternalPodToPod| | \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstevenayers%2Fnetkat","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstevenayers%2Fnetkat","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstevenayers%2Fnetkat/lists"}