Unisphere for PowerMax 10.x: RESTAPI를 통해 디바이스 수준 메트릭을 가져오는 방법

이 문서에서는 REST API를 통해 Unisphere for PowerMax 10.x 인스턴스에 대한 디바이스 수준 메트릭을 수집하는 방법을 검토합니다.

각 RESTAPI 호출에는 다음 세 가지가 필요합니다.

• A URL
• 통화 유형
• 페이로드

볼륨 메트릭을 수집하기 위한 URL은 다음과 같습니다.

• https://< IPorFQDN:>8443/univmax/restapi/performance/볼륨/메트릭

통화 유형은 다음과 같습니다. POST
페이로드는 JSON에 대해 다음과 같이 구성됩니다. (XML의 경우 "추가 정보" 섹션 참조)

{
"systemId": "000xxxxxxxxx",
"volumeStartRange": "xxxxx",
"volumeEndRange": "xxxxx",
"dataFormat": "Maximum",
"endDate":xxxxxxxxxxxxxx,
"metrics": [
"metric1",
"metric2",
"metric3",
"etc"
],
"startDate": xxxxxxxxxxxxxxx
}

각 필드에는 요구 사항이 있습니다. 이는 다음 필드를 사용하는 모든 호출에 적용됩니다. 

• "systemId" 에는 어레이 일련 번호 12자리 전체가 필요하며 따옴표로 묶어야 합니다.
• "volumeStartRange" 및 "volumeEndRange" 는 모두 5자리 디바이스 ID가 필요하며 따옴표로 묶어야 합니다. (예, 두 개 이상 가질 수 있습니다.)
• "dateFormat"은 Maximum 또는 Average일 수 있으며 따옴표로도 사용할 수 있습니다.
• "startDate" 및 "endDate" 는 밀리초 단위의 EPOCH 타임스탬프입니다(날짜 및 시간 포함).
• "metrics" 여러 메트릭을 나열할 수 있지만 따옴표로 묶고 쉼표로 구분해야 합니다.

유효한 URL, 통화 유형 및 페이로드가 있으면 유효한 통화가 있는 것입니다. 그러나 볼륨 메트릭의 경우 백엔드의 디바이스에 대한 추가 제한 사항이 있습니다.

• 볼륨은 SG에 있어야 합니다.
• SG는 MV에 있어야 합니다.
• SG는 시스템 등록의 "스토리지 그룹 실시간" 메트릭 수집 목록에 있어야 합니다.
• SG를 Real-time에 추가하는 경로는 다음과 같습니다. 설정 >공연>시스템 등록> 클립보드를 클릭합니다.

• 마지막으로, 시간 범위는 60분을 초과할 수 없습니다.
  • EPOCK 시간을 밀리초 단위로 작성할 때 시작 날짜와 종료 날짜의 간격이 60분을 넘지 않도록 하십시오. 
  • 호출 테스트 중에는 5분과 같이 더 짧은 기간을 수행하는 것이 좋습니다. 

모든 제한 사항이 충족되면 호출을 실행하고 디바이스 메트릭이 포함된 HTTP 200 응답 코드를 가져올 수 있습니다.

 

다음은 필요할 수 있는 몇 가지 추가 정보입니다.

디바이스 수준 메트릭 호출에 대한 XML 페이로드 형식:

<volumeParam xmlns="http://www.emc.com/em/2012/07/univmax/restapi/performance">
  <startDate>...</startDate>
  <endDate>...</endDate>
  <systemId>...</systemId>
  <volumeStartRange>...</volumeStartRange>
  <volumeEndRange>...</volumeEndRange>
  <commaSeparatedStorageGroupList>...</commaSeparatedStorageGroupList>
  <dataFormat>...</dataFormat>
  <metrics>...</metrics>
</volumeParam>

10.x의 모든 주요 변경 사항을 보려면 다음을 참조하십시오. 새로운 기능-in-powermax-rest-api

RESTAPI의 경우 다음 단계를 사용하여 Unisphere 버전별 설명서를 수집할 수 있습니다. 이 설명서는 호출 및 페이로드 구조에 필요한 항목을 찾는 데 도움이 될 수 있습니다. 

1. 다음으로 이동하여 RESTAPI 문서 파일을 다운로드합니다.
   • https://UNIVMAX_IP:UNIVMAX_PORT/univmax/restapi/docs (영문)
   • UNIVMAX_IP는 IP 주소이고 UNIVMAX_PORT는 Unisphere를 실행하는 호스트의 포트입니다.
2. 문서를 보관할 위치로 파일을 이동합니다.
3. .zip 파일 콘텐츠의 압축을 풉니다.
4. 압축을 푼 파일 목록에서 "index.html"라는 파일을 찾습니다.
5. "index.html"를 엽니다.
   • 설명서에 액세스하는 방법이므로 이 파일의 위치를 기억하십시오.
   • 웹 브라우저에서 창이 열려야 합니다.

이 KB 문서를 작성할 당시 가능한 디바이스 레벨 메트릭은 다음과 같습니다.

EPOCH 타임스탬프는 EPOCHconverter와 같은 다른 웹사이트에서 생성할 수 있습니다. 
이 사이트는 Dell 사이트가 아니므로 Dell은 기능이나 지원을 통제할 수 없습니다.