nthlayer config¶

Manage NthLayer configuration.

Commands¶

nthlayer config show              # Show current configuration
nthlayer config init              # Interactive configuration wizard
nthlayer config set KEY VALUE     # Set a configuration value

nthlayer config show¶

Display current configuration:

nthlayer config show

============================================================
  NthLayer Configuration
============================================================

Config file: /Users/you/.nthlayer/config.yaml

Prometheus:
  Default profile: default
  [default] *
    Type: prometheus
    URL: http://localhost:9090

Grafana:
  Default profile: default
  [default] *
    Type: grafana
    URL: http://localhost:3000
    Org ID: 1
    API Key: ****

Alerting:
  PagerDuty: enabled
    Escalation Policy: P123ABC
  Slack: disabled
  Datadog: disabled

Reveal Secrets¶

nthlayer config show --reveal-secrets

nthlayer config init¶

Interactive wizard for advanced configuration:

nthlayer config init

This is the advanced version of nthlayer setup with options for:

Multiple environment profiles
Cloud secret backends (Vault, AWS, Azure, GCP, Doppler)
Detailed alerting configuration

nthlayer config set¶

Set individual configuration values:

# Set Prometheus URL
nthlayer config set prometheus.profiles.default.url http://prometheus:9090

# Set Grafana API key (prompts for secret)
nthlayer config set grafana.profiles.default.api_key --secret

# Enable PagerDuty
nthlayer config set alerting.pagerduty.enabled true

Configuration File¶

Located at ~/.nthlayer/config.yaml:

prometheus:
  default: default
  profiles:
    default:
      name: default
      type: prometheus
      url: http://localhost:9090
    production:
      name: production
      type: grafana-cloud
      url: https://prometheus-prod.grafana.net
      username: 12345
      password_secret: prometheus/prod/password

grafana:
  default: default
  profiles:
    default:
      name: default
      type: grafana
      url: http://localhost:3000
      org_id: 1
      api_key_secret: grafana/api_key

alerting:
  pagerduty:
    enabled: true
    api_key_secret: pagerduty/api_key
    default_escalation_policy: P123ABC
  slack:
    enabled: false
    webhook_url_secret: slack/webhook_url
    default_channel: "#alerts"
  datadog:
    enabled: false

Environment Variables¶

Override configuration with environment variables:

# Prometheus
export NTHLAYER_PROMETHEUS_URL=http://prometheus:9090

# Grafana
export NTHLAYER_GRAFANA_URL=http://grafana:3000
export NTHLAYER_GRAFANA_API_KEY=glsa_xxxxx
export NTHLAYER_GRAFANA_ORG_ID=1

# PagerDuty
export PAGERDUTY_API_KEY=u+xxxxx

Multiple Profiles¶

Use different configurations for different environments:

# Use production profile
export NTHLAYER_PROFILE=production
nthlayer apply service.yaml

# Or specify inline
nthlayer apply service.yaml --profile production