새 Grafana API로 마이그레이션하기
새 Grafana API로 마이그레이션하기
Grafana가 기존 API를 새 /apis 모델(표준화된 API 구조와 일관된 API 버전 관리를 따르는 Kubernetes 스타일 API 계층)로 옮기는 과정을 소개하는 문서예요. 새 API가 어떤 것인지, 레거시 API가 언제까지 유지되는지, 그리고 어떤 API가 마이그레이션되지 않는지를 확인할 수 있어요.
업그레이드 전에 레거시 API의 폐기(deprecation) 일정과 마이그레이션 범위를 정확히 파악해 두면 서비스 중단 없이 준비할 수 있어요.
출처: 문서
본문
Note
새 API는 Grafana 12 이상에서 사용할 수 있습니다. 레거시 API는 Grafana 13부터 폐기(deprecated)됩니다.
Grafana는 기존 API를 새 /apis 모델로 마이그레이션하고 있어요. 이 모델은 표준화된 API 구조와 일관된 API 버전 관리를 따르는 Kubernetes 스타일의 API 계층이에요. 자세한 내용은 Grafana의 새 API 구조 문서를 참고하세요.
레거시 API는 현재 비활성화되지 않습니다. 레거시 API의 제거는 향후 주요 릴리스에서 계획되어 있으며, 발생할 수 있는 breaking changes는 서비스 중단을 피하기 위해 사전에 충분히 공지됩니다.
폐기(Deprecation) 참고 사항
API 마이그레이션은 진행 중이며, 사용 중인 레거시 API와 정확히 일치하는 /apis 항목이 없을 수도 있어요. 일부 레거시 API는 전혀 마이그레이션되지 않을 수 있습니다. 자세한 내용은 사용 가능한 HTTP API 목록 표를 참고하세요.
Query history API
Query History API는 마이그레이션되지 않습니다.
이 기능은 폐기됩니다. Grafana는 이 기능에 대해 로컬 기기 저장소(on-device storage)를 다시 사용하게 됩니다. 이 방식은 기능 변화를 최소화하면서 백엔드로의 트래픽을 줄여주기 때문이에요. 이 API를 사용하고 있다면 유사한 방식을 고려해 보세요.