Skip to main content

Configuration

Overview

The OpsWorker Kubernetes Agent is configured through Helm values during installation or upgrade.

Options

Required

ValueDescription
clusterTokenAuthentication token from the OpsWorker portal (required)

Resources

ValueDefaultDescription
resources.requests.cpu100mCPU request
resources.requests.memory128MiMemory request
resources.limits.cpu200mCPU limit
resources.limits.memory256MiMemory limit

Scheduling

ValueDefaultDescription
nodeSelector{}Node selector for pod scheduling
tolerations[]Tolerations for tainted nodes
affinity{}Affinity rules for pod placement

Network

ValueDefaultDescription
proxy.httpHTTP proxy URL
proxy.httpsHTTPS proxy URL
proxy.noProxyNo-proxy list

Image

ValueDefaultDescription
image.repositoryopsworker/agentContainer image repository
image.tagLatestSpecific agent version
image.pullPolicyIfNotPresentImage pull policy

Grafana MCP (Optional)

Enable the Grafana MCP sidecar to allow AI agents to query your Grafana instance during investigations and chat. This is a separate integration from Grafana Alerting (webhook). See Grafana MCP Setup.

ValueDefaultDescription
grafana-mcp.enabledfalseEnable the Grafana MCP sidecar
grafana-mcp.grafanaUrlYour Grafana instance URL (e.g., https://grafana.example.com)
grafana-mcp.grafanaTokenGrafana service account token (Viewer role)

Example values.yaml

clusterToken: "your-cluster-token-here"

resources:
requests:
cpu: 100m
memory: 128Mi
limits:
cpu: 200m
memory: 512Mi

nodeSelector:
kubernetes.io/os: linux

tolerations:
- key: "dedicated"
operator: "Equal"
value: "monitoring"
effect: "NoSchedule"

proxy:
https: "http://proxy.internal:3128"
noProxy: "10.0.0.0/8,172.16.0.0/12"

# Optional: Enable Grafana MCP for observability queries
grafana-mcp:
enabled: true
grafanaUrl: "https://grafana.example.com"
grafanaToken: "glsa_xxxxxxxxxxxx"

Applying Configuration Changes

Update configuration with helm upgrade:

helm upgrade opsworker-agent opsworker/opsworker-agent \
-n opsworker \
-f values.yaml

Or override individual values:

helm upgrade opsworker-agent opsworker/opsworker-agent \
-n opsworker \
--set resources.limits.memory=512Mi

Next Steps

  • RBAC — Configure access permissions
  • Scope — Understand the read-only model