[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-73249":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":23,"hasPages":25,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":31,"readmeContent":32,"aiSummary":33,"trendingCount":16,"starSnapshotCount":16,"syncStatus":18,"lastSyncTime":34,"discoverSource":35},73249,"retina","microsoft\u002Fretina","microsoft","eBPF distributed networking observability tool for Kubernetes","https:\u002F\u002Fretina.sh",null,"Go",3144,287,28,120,0,1,2,11,3,63.48,"MIT License",false,"main",true,[27,28,29,30],"ebpf","kubernetes","networking","observability","2026-06-12 04:01:08","\u003Ch1 align=\"center\">\n  \u003Cpicture>\n    \u003Csource media=\"(prefers-color-scheme: light)\" srcset=\"site\u002Fstatic\u002Fimg\u002FRetina-logo-horizontal.png\">\n    \u003Cimg src=\"site\u002Fstatic\u002Fimg\u002FRetina-logo-horizontal.png\" alt=\"Retina Logo\" width=\"30%\">\n  \u003C\u002Fpicture>\n\u003C\u002Fh1>\n\n[![Open in GitHub Codespaces](https:\u002F\u002Fgithub.com\u002Fcodespaces\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002Fcodespaces\u002Fnew?hide_repo_select=true&ref=main&repo=746962176)\n\n[![goreport][goreport-img]][goreport] ![GitHub release][release-img] [![retina-publish][godoc-badge]][godoc] ![license]\n\n[![retina-test][retina-test-image-badge]][retina-test-image] [![retinash][retinash-badge]][retinash] [![retina-publish][retina-publish-badge]][retina-publish] ![retina-codeql-img][retina-codeql-badge] ![retina-golangci-lint-img][retina-golangci-lint-badge]\n\n## Overview\n\nRetina 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.\n\nRetina **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).\n\n## Features\n\n- **[eBPF](https:\u002F\u002Febpf.io\u002Fwhat-is-ebpf#what-is-ebpf)-based** Network Observability platform for Kubernetes workloads.\n- **On-Demand** and **Configurable**.\n- Actionable, industry-standard **Prometheus metrics**.\n- Streamlined **Packet Captures** for deep dives.\n- **Cloud-agnostic**, supporting multiple OS (like Linux, Windows, Azure Linux).\n\n## Why Retina?\n\nRetina lets you **investigate network issues on-demand** and **continuously monitor your clusters**. For scenarios where Retina shines, see the intro docs [here](https:\u002F\u002Fretina.sh\u002Fdocs\u002FIntroduction\u002Fintro)\n\n## Documentation\n\nSee [retina.sh](http:\u002F\u002Fretina.sh) for documentation and examples.\n\n## Known Limitations\n\n⚠️ **Performance on High-Core-Count Systems**: Community users have reported performance considerations when using Advanced metrics (with `packetparser` plugin) on nodes with 32+ CPU cores under high network load. Consider starting with Basic metrics mode on large node types. See [Known Limitations](https:\u002F\u002Fretina.sh\u002Fdocs\u002FIntroduction\u002Fintro#known-limitations) for details.\n\n⚠️ **Windows Server 2019**: Retina no longer supports Windows Server 2019 nodes. Use Windows Server 2022 for Windows workloads.\n\n## Capabilities\n\nRetina has two major features:\n\n- [Metrics](https:\u002F\u002Fretina.sh\u002Fdocs\u002FMetrics\u002Fmetrics-intro)\n- [Captures](https:\u002F\u002Fretina.sh\u002Fdocs\u002FCaptures\u002Foverview)\n\n### Metrics Quick Install Guide\n\nRetina can be installed using the Helm chart from GHCR:\n\n```bash\n# Set the version to a specific version here or get latest version from GitHub API.\nVERSION=$( curl -sL https:\u002F\u002Fapi.github.com\u002Frepos\u002Fmicrosoft\u002Fretina\u002Freleases\u002Flatest | jq -r .name)\nhelm upgrade --install retina oci:\u002F\u002Fghcr.io\u002Fmicrosoft\u002Fretina\u002Fcharts\u002Fretina \\\n    --version $VERSION \\\n    --set image.tag=$VERSION \\\n    --set operator.tag=$VERSION \\\n    --set logLevel=info \\\n    --set enabledPlugin_linux=\"\\[dropreason\\,packetforward\\,linuxutil\\,dns\\]\"\n```\n\nSet the `version` and image `tag` arguments to the desired version, if different.\n\nAfter Helm install, follow the steps for setting up [Prometheus](https:\u002F\u002Fretina.sh\u002Fdocs\u002FInstallation\u002Fprometheus) and [Grafana](https:\u002F\u002Fretina.sh\u002Fdocs\u002FInstallation\u002Fgrafana) to configure metrics collection and visualization.\n\n### Captures Quick Start Guide\n\n#### Captures via CLI\n\nThe preferred way to install the Retina CLI using [Krew](https:\u002F\u002Fkrew.sigs.k8s.io\u002F).\n\n```bash\nkubectl krew install retina\n```\n\nOther installation options are documented in [CLI Installation](https:\u002F\u002Fretina.sh\u002Fdocs\u002FInstallation\u002FCLI).\n\nVerify installation:\n\n```bash\n$ kubectl retina\nRetina is an eBPF distributed networking observability tool for Kubernetes.\n\nUsage:\n  kubectl-retina [command]\n\nAvailable Commands:\n  capture     Capture network traffic\n  completion  Generate the autocompletion script for the specified shell\n  config      Configure retina CLI\n  help        Help about any command\n  shell       [EXPERIMENTAL] Interactively debug a node or pod\n  trace       Retrieve status or results from Retina\n  version     Show version\n\nFlags:\n  -h, --help   help for kubectl-retina\n\nUse \"kubectl-retina [command] --help\" for more information about a command.\n```\n\nTo quickly start creating a capture:\n\n```bash\nkubectl retina capture create --pod-selectors \u003Capp=my-app>\n```\n\nFor further CLI documentation, see [Capture with Retina CLI](https:\u002F\u002Fretina.sh\u002Fdocs\u002FCaptures\u002Fcli).\n\n#### Captures via CRD\n\nInstall Retina using Helm:\n\n```bash\nVERSION=$( curl -sL https:\u002F\u002Fapi.github.com\u002Frepos\u002Fmicrosoft\u002Fretina\u002Freleases\u002Flatest | jq -r .name)\nhelm upgrade --install retina oci:\u002F\u002Fghcr.io\u002Fmicrosoft\u002Fretina\u002Fcharts\u002Fretina \\\n    --version $VERSION \\\n    --set image.tag=$VERSION \\\n    --set operator.tag=$VERSION \\\n    --set image.pullPolicy=Always \\\n    --set logLevel=info \\\n    --set os.windows=true \\\n    --set operator.enabled=true \\\n    --set operator.enableRetinaEndpoint=true \\\n    --skip-crds \\\n    --set enabledPlugin_linux=\"\\[dropreason\\,packetforward\\,linuxutil\\,dns\\,packetparser\\]\"\n```\n\nThen follow steps in [Capture CRD](https:\u002F\u002Fretina.sh\u002Fdocs\u002FCaptures\u002Foverview\u002F#option-2-capture-crd-custom-resource-definition) for documentation of the CRD and examples for setting up Captures.\n\n## Contributing\n\nThis project welcomes contributions and suggestions. Most contributions require you to agree to a\nContributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us\nthe rights to use your contribution. For details, visit \u003Chttps:\u002F\u002Fcla.opensource.microsoft.com>.\n\nWhen you submit a pull request, a CLA bot will automatically determine whether you need to provide\na CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions\nprovided by the bot. You will only need to do this once across all repos using our CLA.\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https:\u002F\u002Fopensource.microsoft.com\u002Fcodeofconduct\u002F).\nFor more information see the [Code of Conduct FAQ](https:\u002F\u002Fopensource.microsoft.com\u002Fcodeofconduct\u002Ffaq\u002F) or\ncontact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\n[Read more about how to begin contributing here.](https:\u002F\u002Fretina.sh\u002Fdocs\u002FContributing\u002Foverview)\n\n### Verify signed images\n\nRetina images published to GHCR are cryptographically signed. You can verify their provenance with [`sigstore\u002Fcosign`](https:\u002F\u002Fgithub.com\u002Fsigstore\u002Fcosign):\n\n```shell\nREPO=microsoft\u002Fretina # or your repo\nIMAGE=retina-operator # or other image to verify\n# This can be replaced with another tag to verify, or with the image SHA256\nLATEST_TAG=$(curl -s https:\u002F\u002Fapi.github.com\u002Frepos\u002Fmicrosoft\u002Fretina\u002Freleases | jq -r '.[0].name')\ncosign verify ghcr.io\u002F$REPO\u002F$IMAGE:$LATEST_TAG --certificate-oidc-issuer https:\u002F\u002Ftoken.actions.githubusercontent.com --certificate-identity-regexp=\"https:\u002F\u002Fgithub.com\u002F$REPO\" -o text\n```\n\n### Office Hours and Community Meetings\n\nWe host a periodic open community meeting. [Find the details here.](https:\u002F\u002Fretina.sh\u002Fdocs\u002FContributing\u002Foverview#office-hours-and-community-meetings)\n\n## Trademarks\n\nThis project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft\ntrademarks or logos is subject to and must follow [Microsoft's Trademark & Brand Guidelines](https:\u002F\u002Fwww.microsoft.com\u002Fen-us\u002Flegal\u002Fintellectualproperty\u002Ftrademarks\u002Fusage\u002Fgeneral).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\nAny use of third-party trademarks or logos are subject to those third-party's policies.\n\n## License\n\nSee the [LICENSE](LICENSE).\n\n## Code of Conduct\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https:\u002F\u002Fopensource.microsoft.com\u002Fcodeofconduct\u002F). For more information see the [Code of Conduct FAQ](https:\u002F\u002Fopensource.microsoft.com\u002Fcodeofconduct\u002Ffaq\u002F) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\n## Contact\n\nFor bugs or feature requests, open an [issue](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fretina\u002Fissues).\nFor security or vulnerability concerns, see [SECURITY.md](SECURITY.md).\nFor other communication, contact the maintainers at \u003Cretina@microsoft.com>.\n\n[goreport-img]: https:\u002F\u002Fgoreportcard.com\u002Fbadge\u002Fgithub.com\u002Fmicrosoft\u002Fretina\n[goreport]: https:\u002F\u002Fgoreportcard.com\u002Freport\u002Fgithub.com\u002Fmicrosoft\u002Fretina\n[godoc]: https:\u002F\u002Fgodoc.org\u002Fgithub.com\u002Fmicrosoft\u002Fretina\n[godoc-badge]: https:\u002F\u002Fgodoc.org\u002Fgithub.com\u002Fmicrosoft\u002Fretina?status.svg\n[release-img]: https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fv\u002Frelease\u002Fmicrosoft\u002Fretina.svg\n[license]: https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-MIT-blue?link=https%3A%2F%2Fgithub.com%2Fmicrosoft%2Fretina%2Fblob%2Fmain%2FLICENSE\n[retina-test-image-badge]: https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fretina\u002Factions\u002Fworkflows\u002Ftest.yaml\u002Fbadge.svg?branch=main\n[retina-test-image]: https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fretina\u002Factions\u002Fworkflows\u002Ftest.yaml?query=branch%3Amain\n[retinash-badge]: https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fretina\u002Factions\u002Fworkflows\u002Fdocs.yaml\u002Fbadge.svg?branch=main\n[retinash]: https:\u002F\u002Fretina.sh\u002F\n[retina-publish-badge]: https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fretina\u002Factions\u002Fworkflows\u002Fimages.yaml\u002Fbadge.svg?branch=main\n[retina-publish]: https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fretina\u002Factions\u002Fworkflows\u002Fimages.yaml?query=branch%3Amain\n[retina-codeql-badge]: https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fretina\u002Factions\u002Fworkflows\u002Fcodeql.yaml\u002Fbadge.svg?branch=main\n[retina-golangci-lint-badge]: https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fretina\u002Factions\u002Fworkflows\u002Fgolangci-lint.yaml\u002Fbadge.svg?branch=main\n","Retina 是一个基于 eBPF 的 Kubernetes 网络可观测性平台，为应用健康、网络安全和合规性提供集中化的监控中心。它通过收集可定制的遥测数据，并支持多种存储选项（如Prometheus、Azure Monitor等）和可视化工具（如Grafana、Azure Log Analytics等），来帮助集群网络管理员、安全管理员及DevOps工程师更好地理解和管理其Kubernetes环境中的网络状况。Retina具有按需配置能力，能够生成行业标准的Prometheus指标，并支持简化的数据包捕获功能以进行深入分析。此外，该工具云无关且跨操作系统兼容，适用于需要对Kubernetes工作负载执行细致网络监控的各种场景。","2026-06-11 03:44:41","high_star"]