{"id":15057008,"url":"https://github.com/alibaba/kubeskoop","last_synced_at":"2026-01-12T06:35:30.883Z","repository":{"id":65663639,"uuid":"589651556","full_name":"alibaba/kubeskoop","owner":"alibaba","description":"Network monitoring \u0026 diagnosis suite for Kubernetes","archived":false,"fork":false,"pushed_at":"2025-03-06T02:04:26.000Z","size":32623,"stargazers_count":634,"open_issues_count":38,"forks_count":78,"subscribers_count":14,"default_branch":"main","last_synced_at":"2025-05-11T04:26:40.198Z","etag":null,"topics":["diagnosis","ebpf","kubernetes","monitoring","network","network-observability"],"latest_commit_sha":null,"homepage":"https://kubeskoop.io","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/alibaba.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":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-01-16T16:07:34.000Z","updated_at":"2025-05-10T16:08:18.000Z","dependencies_parsed_at":"2024-01-10T08:38:54.771Z","dependency_job_id":"f7340e93-251d-4a35-88d1-ecc29e06037a","html_url":"https://github.com/alibaba/kubeskoop","commit_stats":{"total_commits":253,"total_committers":22,"mean_commits":11.5,"dds":0.6758893280632411,"last_synced_commit":"05c2d698bebbfce62b6df12bcc1d7492970a3e15"},"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alibaba%2Fkubeskoop","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alibaba%2Fkubeskoop/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alibaba%2Fkubeskoop/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alibaba%2Fkubeskoop/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alibaba","download_url":"https://codeload.github.com/alibaba/kubeskoop/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253763957,"owners_count":21960484,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["diagnosis","ebpf","kubernetes","monitoring","network","network-observability"],"created_at":"2024-09-24T22:00:22.453Z","updated_at":"2026-01-12T06:35:30.877Z","avatar_url":"https://github.com/alibaba.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"# KubeSkoop\n\n![logo](docs/images/kubeskoop_logo.svg)\n\n![kubeskoop](https://img.shields.io/github/v/tag/alibaba/kubeskoop)\n![license](https://img.shields.io/badge/license-Apache-blue)\n[![Go Report Card](https://goreportcard.com/badge/github.com/alibaba/kubeskoop)](https://goreportcard.com/report/github.com/alibaba/kubeskoop)\n\nEnglish | [简体中文](./README_zh.md)\n\n- [Overview](#overview)\n- [Quick start](#quick-start)\n- [Contributing](#contributing)\n- [Contact](#contact)\n- [License](#license)\n\n## Overview\n\nKubeSkoop is a kubernetes networking diagnose tool for different CNI plug-ins and IAAS providers.\nKubeSkoop automatic construct network traffic graph of Pod in the Kubernetes cluster,\nmonitoring and analysis of the kernel's critical path by eBPF, to resolve most of Kubernetes cluster network problems.\n\n### Key Features\n\n#### One-Shot Diagnose For Network Broken\n\n- Diagnose in-cluster traffic between Pod,Service,Node and Ingress/Egress Traffic.\n- Cover whole linux network stack: Socket,Bridge,Veth,Netfilter,sysctls…\n- Support IaaS network probe for cloud providers.\n\n#### In-Depth Kernel Monitor\n\n- eBPF seamless kernel monitor\n- CO-RE scripts on series kernel by BTF\n- export metrics to standard Prometheus metric API\n\n#### Network Anomaly Event\n\n- support dozens of anomy scenes recognition\n- export anomy event to Grafana Loki or Web Console\n\n#### User-friendly Web Console\n\n- Integrating all capabilities of KubeSkoop, provides network diagnosis, event monitoring, packet capturing, latency detection, etc.\n\n## Quick Start\n\nYou can view the full documentation from the [KubeSkoop.io](https://kubeskoop.io/).\n\n### Installation\n\nYou can quickly deploy KubeSkoop, Prometheus, Grafana and Loki to your cluster via [skoopbundle.yaml](deploy/skoopbundle.yaml).\n\n```bash\nkubectl apply -f https://raw.githubusercontent.com/alibaba/kubeskoop/main/deploy/skoopbundle.yaml\n```\n\n***Note: skoopbundle.yaml starts with the minimum number of replicas and default configurations, which is not suitable for production environments.***\n\nWhen installation is done, you can acess the KubeSkoop Web Console by service `webconsole`.\n\n```bash\nkubectl get svc -n kubeskoop webconsole\n```\n\nYou may need a `Nodeport` or `LoadBalancer` to acess from outside of the cluster.\n\nDefault username is `admin`, and password is `kubeskoop`.\n\n![Web Console](docs/images/web_console.jpg)\n\n### Network diagnosis\n\n#### Connectivity Diagnosis\n\nConnectivity diagnosis can be submitted through the web console.\n\n![Diagnose](docs/images/diagnose.jpg)\n\nUnder **Diagnosis - Connectivity Diagnosis**, you can enter the source address, destination address, port, and protocol for diagnosis, and click `Diagnose` to submit the diagnosis. After the diagnosis is complete, you can see the result in the history list.\n\n![Diagnosis Result](docs/images/diagnosis_result.jpg)\n\n#### Packet Capturing\n\nUnder **Diagnosis - Packet Capturing**，you can perform packet capturing for node/pod in the cluster.\n\n![Packet Capturing](docs/images/packet_capturing.jpg)\n\n#### Latency Detection\n\nUnder **Diagnosis - Latency Detection**，you can detect latencies between multiple nodes and pods.\n\n![Latency Detection](docs/images/ping_mesh.jpg)\n\n### Monitor network jitter and bottlenecks\n\n#### Network Performance Dashboard\n\nView the network permance dashboard from **Monitoring - Dashboard**. In the dashboard, you can check the water level of each monitor item corresponding to the time point of the performance problem.  \n![grafana_performance](docs/images/monitoring.jpg)\n\n#### Network Jitter \u0026 Anomy Event Analysis\n\nUnder **Monitoring - Event**, you can view the anomaly events occurring within the cluster at the current time point. You can also manually select the desired time range, or filter based on event type, node, and information such as the namespace/name of the Pod where the event occurred.\n\nClick `Live` on the right top to view the live event stream according to the current filters.\n![Events](docs/images/events.jpg)\n\n#### Network Link Graph\n\nUnder the homepage or **Monitoring - Network Graph**, you can see the actual network link graph in the cluster, with time and namespaces. You can also switch view mode to `Table` to view each connection.\n\n![Network Graph Table](docs/images/network_graph_table.jpg)\n\n## Contributing\n\nFeel free to open issues and pull requests. Any feedback is much appreciated!\n\n### Contributors\n\nThis project exists, thanks to all the people who contributed.\n\n\u003ca href=\"https://github.com/alibaba/kubeskoop/graphs/contributors\"\u003e\u003cimg src=\"https://opencollective.com/kubeskoop/contributors.svg?width=890\u0026button=false\" /\u003e\u003c/a\u003e\n\n## Contact\n\n- DingTalk Group ID(26720020148)\n\n## License\n\nMost source code in KubeSkoop which running on userspace are licensed under the [Apache License, Version 2.0](LICENSE.md).  \nThe BPF code in `/bpf` directory are licensed under the [GPL v2.0](bpf/COPYING) to compat with Linux kernel helper functions.  \n\n## Security\n\nPlease report vulnerabilities by email to [kubernetes-security@service.aliyun.com](mailto:kubernetes-security@service.aliyun.com). Also see our [SECURITY.md](SECURITY.md) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falibaba%2Fkubeskoop","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falibaba%2Fkubeskoop","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falibaba%2Fkubeskoop/lists"}