MCPcopy Index your code
hub / github.com/MagalixCorp/magalix-agent

github.com/MagalixCorp/magalix-agent @v3.6.3

Chat with this repo
repository ↗ · DeepWiki ↗ · release v3.6.3 ↗ · + Follow
340 symbols 790 edges 36 files 48 documented · 14%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Magalix Agent - Overview Tweet

codecov CircleCI Go Report Card License: MIT

Magalix provides unique insights and recommendations about governance, security, and resources utilization within your Cloud-Native environment. The Magalix agent performs several tasks: 1. It assists with right sizing Kubernetes cluster by dynamically managing resources of pods and containers. Save up to 50% of your cloud bill. Stay on top of capacity management. 2. Allows out-of-the-box, or custom policies-as-code (Rego based) between one, to many of your Kubernetes clusters regardless of where it is hosted, and who it is managed by. 3. Interfaces with your Kube-APIserver / RBAC to gather only the information necessary to provide performance and policy based analytics.

Core Magalix Features

  • Enforce policies at Build, Deploy and Run Time
  • Apply an ever-growing list of policies developed by our internal policy team.
  • Create your own set of policies from scratch, or leverage our templated policies to help boostrap your efforts.
  • Automatically apply optimizations with minimal or no disruption to operations
  • Gain detailed recommendations to right size cluster VMs
  • Provide notification hooks for various external systems when certain events are triggered.

Core Optimization Insights

  • What is the distribution of CPU, memory, and network across the whole cluster?
  • How will utilization look like the next few hours?
  • Are there any unusual usage patterns?
  • How does the change in cluster size impacts performance?

Documentation

The general documentation of the Magalix and its agent, including instructions for installation and dashboards, is located under the docs website.

Installation

A valid account is required to run the agent properly. Please contact sales@magalix.com to set up demo.

Directly through Magalix.com

  1. Go to https://console.magalix.com after your account has been created.
  2. Copy and paste the provided kubectl command into your shell.
  3. It will install Magalix agent with the proper credentials to read your metrics and generate recommendations.

Via GKE Marketplace

You can install Magalix agent through GKE marketplace.

First Time User

  1. Insert your email in GKE installation/configuration form. The deployment container will create an account and connect the agent to this account.
  2. Once installation is successfully complete, you will receive an email with instructions to see your clusters dashboard at Magalix console.
  3. If you didn't receive that welcome email for some reason, you can just go through the reset password process.

If you have an Existing Magalix Account

  1. Insert your email and password in GKE installation/configuration form. The deployment container will define a new cluster under your account and use generated secrets to connect the installed agent with your account.
  2. Once installation is successfully complete, you will receive an email confirming cluster connectivity.

Accessing Insights and Recommendations

A few minutes after the agent is installed, metrics will start to flow. The Magalix Analytics and Recommendations engine will generate predictions and recommendations in a few hours. You will also receive email notifications when recommendations are generated.

Snapshots of recommendations, resources distributions, and namespace resources in a time series

Updating The Agent's Image

If you need to update the running agent's installation, you will receive an email that you should do. Because the image pull policy is set to Always, everytime you delete the pod, a fresh image will be installed.

Removing Magalix Agent

You can remove Magalix agent by simply deleting its Deployment controller, which is named magalix-agent. This will remove all the agent's pods and associated resources.

Troubleshooting

The most common issues that users face installing Magalix agent is RBAC. Please read our troubleshooting guide to resolve initial setup issues you may encounter.

Questions and Support

Please reach out to us at our support forum or send us an email at support@magalix.com.

Extension points exported contracts — how you extend this code

PipeSender (Interface)
PipeSender interface for sender [2 implementers]
client/pipe.go
PipeStore (Interface)
PipeStore store interface for packageges [1 implementers]
client/pipe_store.go
EntitiesWatcherSource (Interface)
(no doc) [2 implementers]
entities/entities.go
ResourceEventHandler (Interface)
(no doc) [2 implementers]
kuber/observer.go
Auditor (Interface)
(no doc) [1 implementers]
agent/governance.go
EntitiesSource (Interface)
(no doc) [1 implementers]
agent/entities.go
Gateway (Interface)
(no doc) [1 implementers]
agent/gateway.go
Identifiable (Interface)
(no doc)
kuber/utils.go

Core symbols most depended-on inside this repo

String
called by 15
proto/kind.go
Exit
called by 15
agent/agent.go
GetKind
called by 11
kuber/utils.go
GetNamespace
called by 10
kuber/utils.go
Lister
called by 9
kuber/observer.go
Add
called by 8
client/pipe_store.go
GetName
called by 8
kuber/utils.go
Start
called by 7
agent/gateway.go

Shape

Method 189
Struct 69
Function 56
Interface 10
FuncType 8
TypeAlias 8

Languages

Go100%

Modules by API surface

proto/packets.go36 symbols
kuber/observer.go36 symbols
entities/entities.go35 symbols
client/pipe_store.go25 symbols
kuber/utils.go16 symbols
auditor/auditor.go16 symbols
auditor/opa-auditor/opa-auditor.go15 symbols
agent/gateway.go14 symbols
agent/entities.go13 symbols
kuber/kube.go12 symbols
client/client.go12 symbols
agent/governance.go12 symbols

For agents

$ claude mcp add magalix-agent \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page