5-1. 에이전트 목록 조회

에이전트 목록 및 상세 페이지

등록된 에이전트 목록을 조회하고, 각 에이전트의 상태, 내부 스토리지 사용 현황을 확인할 수 있습니다.

📘

에이전트(Agent)란 ?

에이전트는 시냅스 내에서 발생하는 다양한 작업들을 보다 효율적이고 분산된 방식으로 실행할 수 있도록 도와주는 보조적 실행자입니다.

시냅스의 에이전트는 데이터 임포트 및 익스포트, 모델 학습, 플러그인 실행 등 복잡하거나 자원이 필요한 작업을 대신 실행해줍니다.

즉, 연산 자원 활용을 최적화하고, 운영 환경을 유연하게 하여 시냅스가 더 빠르고 안정적으로 동작할 수 있도록 지원합니다.


① 상단 메뉴에서 에이전트탭을 선택하면, 등록된 에이전트들이 카드 형태로 표시된 목록 페이지로 이동합니다.

각 카드에는 에이전트의 상태 정보가 시각적으로 제공되어, 한눈에 파악할 수 있습니다.


스토리지 사용 현황 확인


인프라의 에이전트 화면에서 내부(관리서버) 스토리지의 사용 현황을 확인하여, 임포트된 데이터 등으로 누적되는 저장 용량을 직접 점검할 수 있습니다.

🤔

내부(관리서버) 스토리지가 무엇인가요?

데이터 임포트 등으로 수집·누적되는 데이터가 저장되는 관리서버의 저장 공간입니다. 사용 현황을 미리 확인하면 용량 부족으로 인한 데이터 수집·작업 실패를 예방할 수 있습니다.

에이전트 미리보기 화면에서 내부 스토리지의 사용량을 확인합니다.

① 상단 메뉴에서 인프라 탭을 클릭한 후, 에이전트 메뉴를 선택합니다.

② 에이전트 미리보기 영역에서 내부(관리서버) 스토리지 사용 현황을 확인합니다.

  • 사용 용량 / 전체 용량 : 현재 사용 중인 스토리지 용량과 전체 스토리지 용량을 함께 표기합니다.
📘

용량을 미리 점검하세요

대용량 데이터를 임포트하기 전에 스토리지 여유 공간을 확인하면, 용량 부족으로 인한 데이터 수집 실패를 예방할 수 있습니다.


에이전트 카드를 클릭하면 해당 에이전트의 상세 페이지로 진입하며, 정보는 Overview 탭과 Serve 탭으로 구분되어 제공됩니다.

  • Overview: 에이전트의 CPU, Memory, GPU 사용률 등 자원 사용 정보를 확인할 수 있습니다.

🧐

에이전트 현황 페이지 정보

  • IP : Node의 네트워크 주소. agent와 통신할 때 이 주소를 통해 접근함
  • Node : 클러스터에 연결된 하나의 물리 또는 가상 머신(서버)
  • Memory : 해당 Node에 장착된 시스템 메모리(RAM)의 용량 및 사용량
  • CPU : CPU 사용률(%)
  • Disk : Node의 디스크 저장공간(HDD/SSD) 사용량
  • GPUs : Node에 장착된 GPU카드의 목록. 여기에 더 자세한 GPU정보가 포함됨
  • Host name : 해당 Node의 컴퓨터 이름. 클러스터 내에서 구분을 위해 사용됨
  • Utilization : GPU연산 유휴율(%). 높은 숫자일수록 GPU가 활발히 작업중이라는 의미.(0%→대기상태)

  • Serve: 해당 에이전트에서 구동 중인 어플리케이션(예: 스마트툴, AI 추론 등) 목록이 표시되며, 각 어플리케이션별로 할당된 CPU/GPU 자원 정보를 확인할 수 있습니다. 각 항목 우측의 버튼을 클릭하면, 해당 어플리케이션의 README 문서를 확인하거나 어플리케이션을 삭제할 수 있습니다.

📘

Serve 어플리케이션이란 ?

에이전트 내에서 실행되는 개별적인 기능 단위로, AI 모델 추론 서버, 스마트 툴, 데이터 전처리 플러그인 등이 있어요. 에이전트 안에 여러 개의 어플리케이션이 동시에 구동될 수 있어요.


③ Serve 상세 페이지 상단에서 README 버튼을 클릭하면, 해당 Serve App을 API로 활용하는 방법을 안내하는 문서로 이동합니다.

🗝️

README 문서가 보이지 않는다면?

해당 문서는 연동된 GPU 자원을 관리할 수 있는 사용자에게만 표시됩니다.

접근 권한이 없는 경우 페이지가 보이지 않으며, GPU 관리 담당자에게 문의해야 합니다.

📘

에이전트 / 플러그인 / Serve 어플리케이션 개념 정의

  • 에이전트

    → Synapse와 연결된 서버로 학습, 추론, 전처리 등 실제 작업이 실행되는 공간

  • 플러그인

    → 어떤 기능을 실행할 수 있게 만든 코드 묶음(예: 이미지 자동 라벨링, 전처리, 모델 학습 등)

  • Serve 어플리케이션

    → 특정 플러그인을 실제로 실행 가능하게 만든 프로그램

플러그인은 기능 코드 묶음, 어플리케이션은 이 기능을 실행하는 소프트웨어 인스턴스, 에이전트는 그걸 실행시켜주는 컴퓨터입니다.

🧐

어플리케이션은 왜 따로 관리하나요 ?

어플리케이션은 실행될 때 GPU나 CPU 같은 시스템 자원을 많이 사용합니다.
그래서 동시에 여러 어플리케이션이 실행되면 시스템이 느려지거나, 다른 작업에 영향을 줄 수 있어요.

이런 상황을 방지하기 위해, 자원 사용량이 많거나 더 이상 필요하지 않은 어플리케이션은 언제든지 정지하거나 삭제할 수 있어야 합니다.



Did this page help you?