Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: Add vscode documentation in main retina repo. #1326

Merged
merged 2 commits into from
Feb 10, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/01-Introduction/02-architecture.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ To collect this data, Retina observes and hooks on to system events within the k

This section discusses how Retina collects its raw data. More specifically, it discusses how the eBPF programs and plugins are used.

The plugins have a very specific scope by design, and Retina is designed to be extendable, meaning it is easy to add in additional plugins if necessary. If there is a plugin missing for your use case, you can create your own! See our [Development page](../07-Contributing/02-development.md) for details on how to get started.
The plugins have a very specific scope by design, and Retina is designed to be extendable, meaning it is easy to add in additional plugins if necessary. If there is a plugin missing for your use case, you can create your own! See our [Development page](../08-Contributing/02-development.md) for details on how to get started.

The plugins are responsible for installing the eBPF programs into the host kernel during startup. These eBPF programs collect metrics from events in the kernel level, which are then passed to the user space where they are parsed and converted into a `flow` data structure. Depending on the Control Plane being used, the data will either be sent to a Retina Enricher, or written to an external channel which is consumed by a Hubble observer - more on this in the [Control Plane](#control-plane) section below. It is not required for a plugin to use eBPF, it can also use syscalls or other API calls. In either case, the plugins will implement the same [interface](https://github.com/microsoft/retina/blob/main/pkg/plugin/registry/registry.go).

Expand Down
23 changes: 23 additions & 0 deletions docs/07-Consumingtools/vscode.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
# Retina Integration in AKS VS Code Extension

## Overview

Retina is a powerful feature integrated into the Azure Kubernetes Service (AKS) VS Code extension, enabling users to capture and analyze workloads efficiently. This integration simplifies debugging and troubleshooting by providing deep insights into Kubernetes applications.

## Integration Details

The AKS VS Code extension incorporates Retina to enhance cluster observability by capturing snapshots of workloads, logs, and events in real time. Users can:

- Capture workload snapshots directly within VS Code.
- Analyze Kubernetes resources and identify issues.
- Improve troubleshooting efficiency with detailed insights.

## How to Use Retina in the AKS VS Code Extension

1. Install the **[Azure Kubernetes Service](https://marketplace.visualstudio.com/items?itemName=ms-kubernetes-tools.vscode-aks-tools)** extension in VS Code.
2. Connect to an AKS cluster.
3. Navigate to the **Retina Capture** feature.
4. Capture and analyze workloads seamlessly within the VS Code environment.

For a detailed guide on using Retina in AKS, visit:
[Retina Capture in AKS VS Code Extension](https://azure.github.io/vscode-aks-tools/features/retina-capture.html)
2 changes: 1 addition & 1 deletion site/docusaurus.config.ts
Original file line number Diff line number Diff line change
Expand Up @@ -142,7 +142,7 @@ const config = {
items: [
{
label: "Contribute",
href: "https://github.com/microsoft/retina/tree/main/docs/07-Contributing",
href: "https://github.com/microsoft/retina/tree/main/docs/08-Contributing",
},
{
label: "Github",
Expand Down
Loading