서버 관리

서버 정보를 수정하고 원격으로 서버를 제어합니다.

서버 정보 수정

기본 정보 변경

  1. 서버 목록이나 상세 페이지에서 수정 버튼 클릭
  2. 수정할 수 있는 항목:
    • 이름: 서버 식별자
    • 접근 허용 그룹: 접근할 수 있는 사용자 그룹
    • 소유자: 서버 소유자
  3. 저장 클릭

참고: 메트릭 알림은 Metrics 앱에서 관리합니다. 서버 상태 모니터링 - 메트릭 알림을 참고하세요.

서버 상세 정보

서버 상세 페이지에서 다음 정보를 확인할 수 있습니다.

개요 탭:

  • 에이전트 정보(버전, 상태)
  • OS 정보(배포판, 버전)
  • 시스템 정보(CPU, 메모리, 디스크)
  • 운영 정보(가동 시간, 부팅 시간)
  • 설치된 패키지
  • 네트워크 인터페이스
  • 오프라인 알림 기록

마지막 동기화 시간 옆의 지금 새로고침을 클릭하면 다음 예약 동기화를 기다리지 않고 현재 시스템 정보를 바로 가져옵니다.

네트워크 인터페이스 아래의 오프라인 알림 기록에는 이 서버에서 해결된 오프라인 알림이 최신순으로 페이지당 5개씩 표시됩니다. 각 알림의 발생 시각(발생), 해결 시각(해결), 지속 시간(지속 시간), 종료 사유(원인), 해결 알림을 전달한 채널(전달, 알림 기록과 같은 칩)을 확인할 수 있습니다. 원인에는 짧은 이름이 표시되고, 전체 설명은 툴팁에서 볼 수 있습니다. 원인은 재연결, 다시 안정됨(연결 상태가 반복해서 바뀌던 단계가 끝남), 운영 종료, 비활성화, 알림 꺼짐, 삭제됨, 인스턴스 꺼짐, 더 이상 적용되지 않음, 또는 종료 사유를 기록하기 전에 해결된 알림의 경우 기록되지 않음입니다. 이 표는 차트나 메트릭 알림과 달리 Metrics 확장 기능이 없어도 모든 요금제에서 사용할 수 있습니다.

활동 탭:

  • 명령 실행 기록
  • 서버 댓글과 멘션
  • 사용자 활동 로그

접근 탭:

  • 시스템 사용자
  • 시스템 그룹

차트와 메트릭 알림은 서버 상세 페이지가 아닌 Metrics 앱에서 확인할 수 있습니다. 서버 상태 모니터링을 참고하세요.

로그 탭:

  • Alpamon 에이전트의 최근 로그
  • Backhaul 기록(데이터 전송 로그)
  • 전송 상태와 데이터 크기

서버 제어

요구 사항:

  • 서버 상태: 연결됨
  • 권한: 할당된 그룹의 소유자 또는 관리자, 서버 소유자, Staff 또는 Superuser 역할을 가진 사용자

에이전트 카드

서버 상세 페이지의 에이전트 카드에서는 Alpamon 에이전트 자체를 관리할 수 있습니다. 에이전트 버전 옆의 업데이트 정책에는 워크스페이스의 에이전트 업데이트 정책이 최신 버전, 한 릴리스 이전 버전, 수동 중 하나로 표시됩니다.

  • 에이전트 재시작: 에이전트 프로세스를 다시 시작함. 연결 문제를 해결할 때 유용하며, 서버가 잠시 오프라인으로 표시된 뒤 자동으로 다시 연결됨
  • 에이전트 업그레이드: 에이전트를 최신 릴리스로 업데이트하고 다시 시작함. 업데이트 정책이 수동일 때만 버튼이 표시됨. 자동 정책에서는 워크스페이스의 유지보수 시간대 안에서 에이전트가 업그레이드되며 버튼이 표시되지 않음. Windows에서 업그레이드가 적용되지 않으면 설치 프로그램을 다시 실행해야 함(Windows 서버 참고)

버튼을 클릭하고 대화상자에서 확인한 뒤 토스트 메시지로 결과를 확인하세요.

업그레이드는 에이전트를 이전 버전으로 되돌리지 않습니다. 수동 정책에서 에이전트가 이미 최신 릴리스를 실행 중이면 에이전트 업그레이드 버튼은 그대로 보이지만 비활성화되고, 이미 최신 릴리스예요라는 안내가 표시됩니다. 서버에서 업그레이드가 이미 진행 중일 때 다시 요청하면 “이 서버에서 에이전트 업그레이드가 이미 진행 중이에요. 끝난 뒤 다시 시도해 주세요.”라는 메시지와 함께 거부됩니다.

업그레이드 이력

에이전트 카드 아래의 업그레이드 이력에는 이 서버의 에이전트 업그레이드가 최신순으로 5개씩 표시됩니다. 최신과 이전으로 페이지를 넘길 수 있습니다. 자동 업그레이드와 수동 업그레이드가 모두 표시되며, 서버를 볼 수 있는 사람이라면 누구나 이력을 볼 수 있습니다.

각 행에는 다음 내용이 표시됩니다.

  • 결과: 진행 중, 성공, 롤백됨(새 버전이 정상적으로 올라오지 않아 에이전트가 이전 버전으로 돌아감), 실패, 시간 초과(에이전트가 제시간에 업그레이드를 확인하지 않음), 거부됨(에이전트에 도달하기 전에 업그레이드가 철회됨) 중 하나
  • 버전: 업그레이드 전 버전과 업그레이드 후 버전. 예: 1.4.2 → 1.5.0. 에이전트가 결과를 보고하기 전까지는 업그레이드할 버전에 **(목표)**가 붙음
  • 시각과 요청자: 업그레이드를 요청한 시각과 시작한 주체. 멤버의 사용자 이름, API 토큰 이름, 자동 업그레이드라면 **Alpacon 자동 정책 (latest)**로 표시됨
  • 사유: 실패하거나 롤백된 업그레이드는 적용되지 않은 이유가, 거부되거나 실패한 업그레이드는 Alpacon의 짧은 설명이 표시됨

사유 문구는 다음과 같습니다.

문구의미
서명 불일치릴리스 서명이 검증되지 않아 에이전트가 설치하지 않음
다이제스트 불일치다운로드한 패키지가 게시된 체크섬과 일치하지 않음
다운로드 실패에이전트가 릴리스를 다운로드하지 못함
교체 실패에이전트가 자신의 실행 파일을 새 파일로 교체하지 못함
상태 확인 실패새 버전이 시작된 뒤 상태 확인을 통과하지 못함
패키지 관리자 오류시스템 패키지 관리자(apt/yum)가 오류를 보고함
시간대 종료업그레이드가 시작되기 전에 유지보수 시간대가 닫힘
Alpacon 설정 문제로 조치할 필요 없어요Alpacon 쪽 문제. 서버에서 바꿀 것은 없음
알 수 없음에이전트가 원인을 알 수 없는 실패를 보고함

거부됨 행은 대개 업그레이드가 에이전트에 도달하기 전에 유지보수 시간대가 닫혔거나, 정책이 수동으로 바뀌었거나, 대기 중이던 자동 업그레이드를 수동 업그레이드가 대신했거나, Alpacon이 플랫폼 전체의 자동 업그레이드를 일시 중지한 경우입니다. 설치된 것은 없으며 에이전트는 기존 버전으로 계속 실행됩니다.

이력은 업그레이드 이력 기능이 도입된 시점부터 남습니다. 그 전의 업그레이드는 표시되지 않으며, 그 뒤로 업그레이드가 없는 서버에는 “이 기록은 업그레이드 이력이 도입된 시점부터 남아요. 그 전의 업그레이드는 보이지 않아요.”가 표시됩니다. 각 업그레이드는 전송될 때와 끝날 때 모두 활동 로그에도 기록되므로, 워크스페이스 활동을 검색하거나 내보낼 때 함께 포함됩니다.

모든 서버의 업그레이드를 한꺼번에 보려면 워크스페이스 설정 에이전트 업데이트의 최근 에이전트 업그레이드나 에이전트 업그레이드 API를 사용하세요.

업그레이드 실패 알림

에이전트 업그레이드가 실패하거나 롤백되면 Alpacon은 해당 서버에 경고 알림을 발생시킵니다. 알림 제목은 에이전트 1.5.0 업그레이드에 실패했습니다와 같은 형식입니다. 이 알림은 알림 종 아이콘과 알림 목록에만 표시되며, 이메일이나 Slack 메시지는 보내지 않고 매시간 발송되는 미해결 알림 요약에도 들어가지 않습니다. 업그레이드가 연달아 실패해도 서버마다 열려 있는 알림은 하나뿐이며, 다음 업그레이드가 성공하면 해결됩니다. 업그레이드가 성공했을 때는 알림을 보내지 않으며, 사유가 Alpacon 설정 문제로 조치할 필요 없어요인 실패에도 알림을 발생시키지 않습니다.

호스트 작업

서버를 재부팅하거나 종료하거나 운영체제 패키지를 업그레이드할 때는 서버 페이지의 버튼 대신 작업 세션에서 명령을 실행하세요. 세션에서 Websh를 열거나 --work-session으로 alpacon exec를 세션에 연결한 뒤, 다른 관리자 권한 명령과 마찬가지로 sudo를 사용하세요. 예를 들어 sudo reboot, sudo shutdown -h now, sudo apt upgrade -y 또는 사용 중인 플랫폼의 패키지 관리자 명령을 실행할 수 있습니다. alpacon exec --work-session SESSION_ID my-server -- sudo reboot를 실행하면 SESSION_ID 세션에서 my-server가 재부팅됩니다. 이 작업에는 워크스페이스의 sudo 정책, MFA, 승인 규칙이 적용되며 Alpacon은 다른 세션과 마찬가지로 기록을 남깁니다. 작업을 계획하고 있다면 먼저 서버 알림을 음소거하세요. 이 방식으로 명령을 실행하면 Alpacon이 오프라인 알림을 자동으로 보류하지 않습니다.

서버 목록에서 할 수 있는 작업

서버 목록에서 서버를 하나 이상 선택하면 다음 작업을 할 수 있습니다.

  • 선택한 서버가 포함된 작업 세션 요청
  • 선택한 서버의 알림 음소거. 서버 음소거 참고
  • 선택한 서버 삭제. 일괄 삭제 참고

에이전트 재시작과 업그레이드는 목록에서 할 수 없습니다. 각 서버의 상세 페이지에 있는 에이전트 카드를 사용하세요. 시스템 정보 새로고침도 목록에서 할 수 없습니다. 상세 페이지에서 마지막 동기화 시간 옆의 지금 새로고침을 사용하세요.

필터링:

  • 그룹 필터: 특정 그룹의 서버만 표시
  • 상태 필터: 연결된 서버와 연결이 끊긴 서버 구분
  • 검색: 서버 이름으로 빠르게 검색

서버 댓글

서버 관련 정보를 팀원과 공유합니다.

댓글 추가:

  1. 서버 상세 페이지 > 활동 탭
  2. 댓글 입력란에 내용 작성
  3. @username으로 특정 사용자 멘션
  4. 추가 클릭

댓글 고정:

  • 중요한 댓글을 맨 위에 고정, 최대 3개
  • 핀 아이콘을 클릭해 고정하거나 고정 해제

관련 문서

최종 수정: