Alpamon 구성

서버에 별도 인증서나 프록시 설정이 필요할 때 참고하세요. 일반적인 설치에는 워크스페이스에서 생성한 명령을 사용합니다. 절차는 Alpamon 설치를 참고하세요.

구성

구성 파일

구성 파일 위치는 플랫폼에 따라 다릅니다:

  • Linux: /etc/alpamon/alpamon.conf
  • macOS: /etc/alpamon/alpamon.conf
  • Windows: %ProgramData%\alpamon\alpamon.conf

형식 (INI):

ini
[server]
id = your-server-id
key = your-server-key
url = https://your-workspace.ap1.alpacon.io
 
[ssl]
verify = true
# ca_cert = /path/to/ca.crt    # Custom CA certificate (optional)
 
[logging]
debug = false           # Enable verbose debug logging
 
[pool]
max_workers = 20        # Default: 20 concurrent workers
queue_size = 200        # Default: 200 queued jobs
default_timeout = 3600  # Default: 3600 seconds when unset (0 = no timeout)
 
[editor]
idle_timeout = 60       # Default: 60 minutes (0 = disabled)
 
[interface]
include_virtual =      # Default: empty; example: veth0, cali*
exclude_virtual_from_inventory = false # Default: false
 
[file]
# max_download_bytes = 0    # Max download size in bytes for URL fetches (0 = unlimited)
참고

이 파일은 설치 또는 등록 시 자동으로 생성됩니다. 일반적으로 수동으로 편집할 필요가 없습니다.

네트워크 인터페이스 설정

[interface]의 include_virtual에는 인터페이스 이름이나 대소문자를 구분하는 glob 패턴을 쉼표로 나열합니다(예: veth0, cali*). 기본값은 빈 목록입니다. 트래픽 수집 대상에서 제외되는 가상 인터페이스의 트래픽도 수집하려면 이 목록에 추가하세요. 루프백 인터페이스나 하드웨어 주소가 없는 인터페이스는 이 설정으로 추가할 수 없습니다.

exclude_virtual_from_inventory의 기본값은 false입니다. 따라서 트래픽을 수집하지 않는 가상 인터페이스도 보고되는 인터페이스 목록에는 남습니다. 목록에서도 제외하려면 true로 설정합니다.

경고

에이전트가 더 이상 보고하지 않는 인터페이스를 Alpacon 서버가 보존하는지 확인한 뒤에만 exclude_virtual_from_inventory를 켜세요. 서버가 보고되지 않는 인터페이스를 삭제하면 해당 인터페이스의 트래픽 이력도 함께 삭제됩니다.

환경 변수

다음 환경 변수는 패키지 설치 시 자동 등록에 사용됩니다:

bash
# Required for auto-registration
export ALPACON_URL="https://your-workspace.ap1.alpacon.io"
export PLUGIN_ID="your-server-id"
export PLUGIN_KEY="your-server-key"
 
# Optional
export ALPACON_SSL_VERIFY="true"      # SSL certificate verification
export ALPACON_CA_CERT="/path/to/ca.crt"  # CA certificate path
export PLUGIN_DEBUG="false"           # Enable debug logging

프록시 구성

서버가 프록시 뒤에 있는 경우, 설치 명령 또는 alpamon register 실행 전에 HTTP 프록시 환경 변수를 설정합니다:

bash
export http_proxy="http://proxy.example.com:8080"
export https_proxy="http://proxy.example.com:8080"
참고

소문자 형식(http_proxy / https_proxy)을 사용하세요. 워크스페이스에서 생성된 명령과 시스템 패키지 매니저가 이 형식을 읽습니다. sudo -EH의 -EH 플래그는 설치 과정에서 이 변수를 보존합니다.

이 변수는 해당 셸에서 실행한 명령에만 적용됩니다. 설치된 에이전트 서비스는 이 변수를 물려받지 않으므로, 에이전트가 프록시를 거쳐 연결하게 하려면 프록시 지원을 참고하세요.

최종 수정: