# All options defined here are available to all instances.
# Use init_config to set defaults that apply to every dish on this Agent.
#
init_config:

  # Metric group toggles — set to false to disable collection fleet-wide.
  # These reduce bandwidth usage on satellite uplinks.
  # Per-instance settings (below) override these.
  # All groups are enabled by default.

  # collect_performance: true        # 5 metrics: throughput, latency, packet loss, ethernet speed
  # collect_signal: true             # 2 metrics: SNR flags
  # collect_health: true             # 3 metrics: uptime, GPS
  # collect_alerts_core: true        # 7 metrics: thermal, motors, roaming, ethernet, install
  # collect_alerts_extended: true    # 11 metrics: water detection, mast, PSU, signal quality
  # collect_alignment: true          # 8 metrics: azimuth, elevation, tilt, error
  # collect_obstruction: true        # 5 metrics: obstruction fraction, duration
  # collect_power: true              # 2 metrics: dish and router watts
  # collect_outage: true             # 3 metrics: outage cause, duration, first slot
  # collect_init_timing: true        # 5 metrics: boot timing, software update progress
  # collect_ready_states: true       # 6 metrics: subsystem readiness flags
  # collect_location: true           # 3 metrics: GPS lat/lon/altitude (requires satellite lock)

# Every instance monitors one Starlink dish.
# Add one instance block per dish reachable from this Agent.
#
instances:

  ## @param dish_ip - string - required
  ## The IP address and port of the Starlink dish on the local network.
  ## Default dish address is 192.168.100.1 on port 9200.
  #
  - dish_ip: 192.168.100.1:9200

    ## @param tags - list of strings - optional
    ## Tags attached to every metric and service check from this instance.
    ## Use these to identify dish location, vessel, fleet, or deployment context.
    ##
    ## The integration automatically adds tags from dish hardware:
    ##   device_id:<hardware_id>
    ##   hardware_version:<version>
    ##   software_version:<version>
    ##   country:<country_code>
    ##   mobility_class:<class>
    ##
    ## Recommended tags for maritime / fleet deployments:
    #
    # tags:
    #   - fleet:my-fleet
    #   - vessel:my-ship
    #   - ship_class:breakaway-plus
    #   - region:caribbean
    #   - route:miami-cozumel-roatan
    #   - terminal_location:deck-14-forward
    #   - env:production

    ## @param collect_* - boolean - optional
    ## Per-dish overrides for metric group toggles (override init_config for this dish).
    #
    # collect_performance: true
    # collect_signal: true
    # collect_health: true
    # collect_alerts_core: true
    # collect_alerts_extended: true
    # collect_alignment: true
    # collect_obstruction: true
    # collect_power: true
    # collect_outage: true
    # collect_init_timing: true
    # collect_ready_states: true
    # collect_location: true

    ## @param min_collection_interval - number - optional - default: 15
    ## How often (in seconds) the Agent polls this dish and submits metrics.
    ## Payload size per cycle is unchanged — a higher interval reduces uplink frequency.
    ## Use 30–60s on bandwidth-constrained links; keep 15s for alert-critical terminals.
    ## https://docs.datadoghq.com/developers/write_agent_check/#collection-interval
    #
    min_collection_interval: 15

  ## --- Multi-dish example ---
  ## Uncomment and repeat for each additional dish.
  #
  # - dish_ip: 192.168.101.1:9200
  #   tags:
  #     - fleet:my-fleet
  #     - vessel:my-ship
  #     - ship_class:breakaway-plus
  #     - region:caribbean
  #     - route:miami-cozumel-roatan
  #     - terminal_location:deck-14-aft
  #     - env:production
  #
  # - dish_ip: 192.168.102.1:9200
  #   tags:
  #     - fleet:my-fleet
  #     - vessel:my-ship
  #     - ship_class:breakaway-plus
  #     - region:caribbean
  #     - route:miami-cozumel-roatan
  #     - terminal_location:deck-15-port
  #     - env:production

  ## --- Bandwidth-optimized example (maritime) ---
  #
  # - dish_ip: 192.168.100.1:9200
  #   tags:
  #     - fleet:my-fleet
  #     - vessel:my-ship
  #     - ship_class:breakaway-plus
  #     - region:caribbean
  #     - route:miami-cozumel-roatan
  #     - terminal_location:bridge-roof
  #     - env:production
  #   collect_alignment: false
  #   collect_power: false
  #   collect_outage: false
  #   collect_init_timing: false
  #   collect_ready_states: false
  #   collect_location: false