https://github.com/microsoft/retina Skip to content Toggle navigation Sign in * Product + Actions Automate any workflow + Packages Host and manage packages + Security Find and fix vulnerabilities + Codespaces Instant dev environments + Copilot Write better code with AI + Code review Manage code changes + Issues Plan and track work + Discussions Collaborate outside of code Explore + All features + Documentation + GitHub Skills + Blog * Solutions For + Enterprise + Teams + Startups + Education By Solution + CI/CD & Automation + DevOps + DevSecOps Resources + Learning Pathways + White papers, Ebooks, Webinars + Customer Stories + Partners * Open Source + GitHub Sponsors Fund open source developers + The ReadME Project GitHub community articles Repositories + Topics + Trending + Collections * Pricing Search or jump to... Search code, repositories, users, issues, pull requests... Search [ ] Clear Search syntax tips Provide feedback We read every piece of feedback, and take your input very seriously. [ ] [ ] Include my email address so I can be contacted Cancel Submit feedback Saved searches Use saved searches to filter your results more quickly Name [ ] Query [ ] To see all available qualifiers, see our documentation. Cancel Create saved search Sign in Sign up You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session. Dismiss alert {{ message }} microsoft / retina Public * Notifications * Fork 6 * Star 157 * eBPF distributed networking observability tool for Kubernetes retina.sh License MIT license 157 stars 6 forks Branches Tags Activity Star Notifications * Code * Issues 2 * Pull requests 1 * Discussions * Actions * Projects 0 * Security * Insights Additional navigation options * Code * Issues * Pull requests * Discussions * Actions * Projects * Security * Insights microsoft/retina This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository. main BranchesTags Go to file Code Folders and files Name Name Last commit Last commit message date Latest commit History 47 Commits .github .github captureworkload captureworkload cli cli controller controller crd crd deploy deploy docs docs hack/tools hack/tools init/retina init/retina operator operator pkg pkg samples samples scripts scripts site site test test windows windows .gitattributes .gitattributes .gitignore .gitignore .golangci.yaml .golangci.yaml CODE_OF_CONDUCT.md CODE_OF_CONDUCT.md LICENSE LICENSE Makefile Makefile README.md README.md SECURITY.md SECURITY.md SUPPORT.md SUPPORT.md go.mod go.mod go.sum go.sum View all files Repository files navigation * README * Code of conduct * MIT license * Security Retina goreport GitHub release retina-publish license retina-test retinash retina-publish retina-codeql-img retina-golangci-lint-img Overview Retina is a cloud-agnostic, open-source Kubernetes network observability platform that provides a centralized hub for monitoring application health, network health, and security. It provides actionable insights to cluster network administrators, cluster security administrators, and DevOps engineers navigating DevOps, SecOps, and compliance use cases. Retina collects customizable telemetry, which can be exported to multiple storage options (such as Prometheus, Azure Monitor, and other vendors) and visualized in a variety of ways (like Grafana, Azure Log Analytics, and other vendors). Features * eBPF-based Network Observability platform for Kubernetes workloads. * On-Demand and Configurable. * Actionable, industry-standard Prometheus metrics. * Streamlined Packet Captures for deep dives. * Cloud-agnostic, supporting multiple OS (like Linux, Windows, Azure Linux). Why Retina? Retina lets you investigate network issues on-demand and continuously monitor your clusters. For scenarios where Retina shines, see the intro docs here Documentation See retina.sh for documentation and examples. Capabilities Retina has two major features: * Metrics * Captures Metrics Quick Install Guide Prerequisites: Go, Helm 1. Clone the repo, then install Retina on your Kubernetes cluster make helm-install 2. Follow steps in Using Prometheus and Grafana to set up metrics collection and visualization. Captures Quick Start Guide Captures via CLI Currently, Retina CLI only supports Linux. * Option 1: Download from Release Download kubectl-retina from the latest Retina release. Feel free to move the binary to /usr/local/bin/, or add it to your PATH otherwise. * Option 2: Build from source Requirements: + go 1.21 or newer + GNU make Clone the Retina repo and execute: make install-kubectl-retina Execute Retina: kubectl-retina capture create --help For further CLI documentation, see Capture with Retina CLI. Captures via CRD Prerequisites: Go, Helm 1. Clone the repo, then install Retina with Capture operator support on your Kubernetes cluster make helm-install-with-operator 2. Follow steps in Capture CRD for documentation of the CRD and examples for setting up Captures. Contributing This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https:// cla.opensource.microsoft.com. When you submit a pull request, a CLA bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA. This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments. Read more about how to begin contributing here. Office Hours and Community Meetings We host a periodic open community meeting. Find the details here. Trademarks This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow Microsoft's Trademark & Brand Guidelines. Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party's policies. License See the LICENSE. Code of Conduct This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments. Contact For bugs or feature requests, open an issue. For security or vulnerability concerns, see SECURITY.md. For other communication, contact the maintainers at retina@microsoft.com About eBPF distributed networking observability tool for Kubernetes retina.sh Topics kubernetes networking ebpf observability Resources Readme License MIT license Code of conduct Code of conduct Security policy Security policy Activity Custom properties Stars 157 stars Watchers 7 watching Forks 6 forks Report repository Releases 2 v0.0.1 Latest Mar 15, 2024 + 1 release Packages 4 Contributors 24 * @rbtr * @nddq * @anubhabMajumdar * @vakalapa * @timraymond * @matmerr * @feiskyer * @tamilmani1989 * @mainred * @anson627 * @jimassa * @wedaly * @Tatsinnit * @jaer-tsun + 10 contributors Languages * Go 91.4% * Shell 2.3% * C 2.0% * Makefile 1.7% * Python 1.2% * JavaScript 0.7% * Other 0.7% Footer (c) 2024 GitHub, Inc. Footer navigation * Terms * Privacy * Security * Status * Docs * Contact * Manage cookies * Do not share my personal information You can't perform that action at this time.