microsoft/retina

eBPF distributed networking observability tool for Kubernetes

View on GitHub ↗Jump to charts ↓

Summary Information

Updated 50 minutes ago
Added to GitGenius on May 12th, 2024
Created on January 23rd, 2024
Open Issues & Pull Requests: 175 (+0)
Number of forks: 304
Total Stargazers: 3,166 (+0)
Total Subscribers: 28 (+0)

Repository Insights (GitGenius)

Median issue/PR response: 2.3 days
Mean response time: 38.6 days
90th percentile: 118.9 days
Tracked items: 303

How this project is maintained

Around half of the issues opened in the past year never receive a reply. 83% of open issues come from outside the core team, so the backlog reflects real-world use rather than internal planning. Work labelled "area/documentation" is answered fastest, typically in about 19 hours, while "area/metrics" waits about 5 days. Only 5% of issues opened in the past year have been closed. Three people close 54% of everything that gets resolved.

Charts & Analytics

Fetching additional details & charts...

Issue Activity (beta)

Open issues: 123
New in 7 days: 1
Closed in 7 days: 0
Avg open age: 443 days
Stale 30+ days: 117
Stale 90+ days: 114

Recent activity

Opened in 7 days: 1
Closed in 7 days: 0
Comments in 7 days: 0
Events in 7 days: 1

Top labels

  • type/bug (70)
  • help wanted (61)
  • type/enhancement (61)
  • good first issue (53)
  • priority/1 (43)
  • lang/go (40)
  • area/plugins (32)
  • area/metrics (31)

Detailed Description

Retina is a cloud-agnostic, open-source Kubernetes network observability platform developed by Microsoft that provides centralized monitoring for application health, network health, and security. Written primarily in Go, it leverages eBPF technology to collect customizable telemetry from Kubernetes workloads without requiring kernel modifications. The platform exports metrics to multiple storage backends including Prometheus and Azure Monitor, and supports visualization through Grafana, Azure Log Analytics, and other vendor tools, making it suitable for cluster network administrators, security administrators, and DevOps engineers managing DevOps, SecOps, and compliance requirements.

The platform offers two major feature sets: Metrics and Captures. The Metrics capability provides industry-standard Prometheus metrics for continuous cluster monitoring, with both Basic and Advanced modes available. Advanced metrics include packet parsing functionality but may experience performance considerations on high-core-count systems with 32 or more CPU cores under heavy network load. The Captures feature enables on-demand packet capture for deep network investigation, accessible through both a CLI tool installable via Krew and a Kubernetes Custom Resource Definition approach. Retina supports multiple operating systems including Linux, Windows Server 2022, and Azure Linux, though Windows Server 2019 is no longer supported.

Installation is streamlined through Helm charts distributed via GHCR, with published images cryptographically signed for provenance verification using cosign. The platform emphasizes configurability and actionable insights, allowing users to investigate network issues on-demand while maintaining continuous monitoring capabilities across their clusters.

The project follows Microsoft's open-source governance model, requiring Contributor License Agreements and adhering to the Microsoft Open Source Code of Conduct. Community meetings are hosted periodically to facilitate discussion and contribution guidance, with detailed documentation available at retina.sh covering installation, configuration, and contribution procedures.