이 페이지는 기계 번역을 사용하여 번역되었습니다. 최신 내용을 영문으로 보려면 여기를 클릭하십시오.
Polyspace Access 성능 모니터링
사용자 활동, 백그라운드 프로세스, 데이터베이스 사용량과 관련된 다양한 메트릭을 Polyspace® Access™에 쿼리할 수 있습니다. 이러한 측정 항목을 사용하면 Polyspace Access 서버의 상태를 모니터링하고, 추세와 잠재적 문제를 파악하고, 서버 성능과 안정성을 최적화할 수 있습니다.
Polyspace Access에 대한 서버 메트릭을 쿼리하려면 polyspace/api/monitoring 엔드포인트를 사용하세요. 예를 들어, Polyspace Access 인스턴스가 포트 9443에서 호스트 이름이 access-example-server인 머신에서 실행되는 경우 다음 URL을 사용합니다.
http(s)://access-example-server:9443/polyspace/api/monitoring
서버 메트릭 형식 및 설명
Polyspace Access에 서버 메트릭을 쿼리하면 서버는 사람이 읽을 수 있는 Prometheus 텍스트 기반 형식으로 데이터를 반환하며, 이 데이터는 서버 성능 모니터링 플랫폼과 쉽게 통합할 수 있습니다. 텍스트 기반 Prometheus 형식에 대한 자세한 내용은 텍스트 기반 형식을 참조하세요.
이 표는 Polyspace Access가 반환하는 메트릭을 설명합니다.
| 메트릭 | 설명 |
|---|---|
psaccess_db_size_bytes | Polyspace Access 데이터베이스의 크기 numBytes (바이트) |
| 현재 Polyspace Access에 저장된 프로젝트 numProjects의 개수입니다. active="false"인 경우 숫자는 ProjectsWaitingForDeletion 폴더에서 삭제 대기 중인 프로젝트를 나타냅니다. 이 폴더의 프로젝트는 Polyspace Access 관리자에게만 표시됩니다. |
| 현재 Polyspace Access에 저장된 실행 횟수 numRuns. active="false"인 경우 숫자는 ProjectsWaitingForDeletion 폴더에서 삭제 대기 중인 실행을 나타냅니다. 이 폴더의 실행은 Polyspace Access 관리자에게만 표시됩니다. |
psaccess_users_connected_total | 현재 Polyspace Access에 로그인한 사용자 수 Polyspace는 고유한 사용자 이름 로그인만 계산합니다. 동일한 사용자가 두 개의 서로 다른 장치 또는 웹 브라우저에서 로그인한 경우 이는 하나의 사용자 로그인으로 계산됩니다. |
psaccess_jobs_queued_total{type="upload | review_transfer | download | project_deletion"} | 현재 Polyspace Access 대기열에서 대기 중인 작업
|
psaccess_jobs_processing_total{type="upload | review_transfer | download | project_deletion"} | Polyspace Access가 현재 처리 중인 작업 numJobs의 수. 작업 유형에 대한 설명은 psaccess_jobs_queued_total 설명을 참조하세요. |
psaccess_jobs_completed_total{type="upload | review_transfer | download | project_deletion"} | Polyspace Access가 성공적으로 처리한 작업 numJobs의 수. 작업 유형에 대한 설명은 psaccess_jobs_queued_total 설명을 참조하세요. |
psaccess_jobs_failed_total{type="upload | review_transfer | download | project_deletion"} | 완료하지 못한 작업 numJobs 수입니다. 작업 유형에 대한 설명은 psaccess_jobs_queued_total 설명을 참조하세요. |
psaccess_jobs_queued_delay_seconds{type="upload | review_transfer | download | project_deletion"} | 대기열에서 가장 오래된 작업의 수명은 queueAge(초)입니다. 작업 유형에 대한 설명은 psaccess_jobs_queued_total 설명을 참조하세요. |
psaccess_jobs_processing_delay_seconds{type="upload | review_transfer | download | project_deletion"} | Polyspace Access가 현재 처리 중인 가장 오래된 작업의 나이를 초 단위로 jobAge로 표시합니다. 작업 유형에 대한 설명은 psaccess_jobs_queued_total 설명을 참조하세요. |
Polyspace Access을 모니터링하기 위한 Grafana 대시보드 생성
이 예제에서는 Prometheus® 데이터 소스를 구성하여 Polyspace Access에 대한 서버 메트릭을 쿼리하고 Grafana® 대시보드에서 메트릭을 시각화하는 방법을 보여줍니다.
선행 조건
Grafana 설치. 예를 들어, Docker® 컨테이너에서 Grafana를 실행합니다. Grafana Docker 이미지를 참조하세요.
Prometheus 데이터 소스. 예를 들어, Prometheus를 Docker에서 실행할 수 있습니다. Prometheus Docker 컨테이너를 참조하세요.
Prometheus 데이터 소스 구성
Polyspace Access와 같은 대상에서 데이터를 스크래핑하도록 Prometheus를 구성하려면 대상의 URL, 메트릭을 쿼리하는 데 사용된 HTTP 엔드포인트 및 기타 파라미터를 지정하는 YAML 파일을 사용합니다. 일반적으로 파일 이름은 prometheus.yml 입니다.
이 샘플 YAML 파일은 기본 Polyspace Access 포트(9443)를 사용하여 호스트 이름이 access-example-server인 머신에서 실행되는 Polyspace Access 인스턴스에 대한 구성을 보여줍니다.
참고
이 샘플 구성은 일반적인 구성에서는 권장되지 않는 서버 인증서(insecure_skip_verify)의 유효성 검사를 비활성화합니다.
global:
# How frequently to scrape targets by default.
scrape_interval: 15s
# How long until a scrape request times out.
scrape_timeout: 5s
scrape_configs:
- job_name: "polyspace"
tls_config:
insecure_skip_verify: true
metrics_path: '/polyspace/api/monitoring'
scheme: https
static_configs:
- targets: ["access-example-server:9443"]scrape_config 섹션을 편집하여 Polyspace Access 파라미터를 추가합니다.prometheus.yml 파일을 만들거나 편집한 후 Prometheus 인스턴스를 다시 시작하여 변경 사항을 적용하고 Prometheus가 엔드포인트 polyspace/api/monitoring를 스크래핑할 수 있는지 확인합니다. 스크래핑된 대상의 상태를 보려면 Prometheus 서버 웹 UI의 /targets 페이지로 이동하세요(예: http://localhost:9090/targets). Prometheus가 엔드포인트를 스크래핑할 수 있는 경우 다음과 비슷한 내용이 표시됩니다.
Prometheus 데이터 소스 추가 및 대시보드 생성
Polyspace Access 서버 모니터링을 시작하려면 이전 섹션에서 데이터 소스로 구성한 Prometheus 인스턴스를 Grafana에 추가하세요. 데이터 소스 추가를 참조하세요.
그런 다음 대시보드를 만들어 Polyspace Access 서버 지표를 시각화하거나 기존 대시보드를 편집하여 다른 도구와 함께 Polyspace Access를 모니터링할 수 있습니다. 대시보드를 만들려면 대시보드 만들기를 참조하세요.
Polyspace Access에 대한 CPU 사용률이나 다양한 Polyspace Access Docker 컨테이너의 성능 특성 등 추가적인 지표를 보려면 외부 도구를 사용하여 해당 데이터를 내보낸 다음 대시보드에 통합할 수 있습니다. 데이터를 Prometheus 메트릭으로 내보내는 라이브러리 및 서버 목록은 내보내기 및 통합을 참조하세요.
