API 전략의 성공을 보장하는 12가지 모니터링 지표

오픈소스 중국 커뮤니티 팀이 공유라는 이름으로 오픈소스 중국 커뮤니티의 뒷이야기를 전하는 첫 생방송을 진행했습니다."

원저자: F5의 Andrew Stiefel

원본 링크: 성공적인 API 전략을 보장하는 12가지 모니터링 지표

재판 소스: NGINX 오픈 소스 커뮤니티

NGINX의 유일한 공식 중국어 커뮤니티(모두 nginx.org.cn)

기업이 최신 애플리케이션을 구축하기 위해 API 우선 설계 방식을 채택함에 따라 이러한 API의 운영 성능과 가치를 측정하는 것이 필수적이 되었습니다. API 측정항목을 명확하게 정의하고 이를 핵심성과지표(KPI)와 연결하는 프레임워크를 구축하는 것은 성공적인 API 전략을 보장하는 가장 중요한 단계 중 하나입니다.

일반적으로 KPI는 특정 목표와 밀접하게 연결되어 있습니다. 명확한 기간이 있으며 API 전략이 제공해야 하는 내용과 일치합니다. 이와 대조적으로 API 측정항목은 중요한 데이터 포인트입니다. 모든 지표가 KPI는 아니지만 모든 KPI는 지표를 기반으로 합니다.

그러면 어떻게 해야 할까요? 먼저 API 전략의 목표를 처음부터 명확히 한 다음 해당 목표에 맞는 지표를 선택해야 합니다. 각 팀은 자신에게 중요하고 비즈니스에 필요한 사항을 기반으로 다양한 측정항목을 측정하고 추적해야 한다는 점을 기억하세요.

광범위하게 말하면, 기업이 추적할 수 있는 API 지표에는 세 가지 광범위한 범주가 있으며, 다양한 지표 범주는 다양한 문제를 반영합니다.

운영 지표 – API가 필요한 안정성, 신뢰성 및 성능을 제공합니까?
채택 지표 – 개발자가 귀하의 API를 채택하고 있습니까?
제품 지표 – API가 귀하의 비즈니스 목표를 어떻게 지원합니까?

이 세 가지 광범위한 지표 범주를 피라미드로 생각할 수 있습니다. 하단의 운영 측정항목은 개별 API와 해당 지원 인프라의 전술적 성능을 측정합니다. 상위 제품 지표는 API로 창출된 비즈니스 가치를 측정합니다. 이 둘은 최종 사용자(개발자) 사이에서 API 프로그램의 성장을 추적하는 채택 지표를 통해 서로 연결되어 있습니다. 일반적으로 제품 지표와 채택 지표는 측정해야 하는 비즈니스 결과와 관련이 있는 반면, 운영 지표는 유지해야 하는 기술 표준과 관련이 있습니다.

이 문서에서는 측정해야 하는 12가지 특정 지표를 분석하고, 인프라 및 애플리케이션 팀을 지원하는 방법을 설명하고, 이러한 지표가 KPI와 어떻게 관련되는지 설명합니다.

작동 및 유지 관리 표시기

초기 단계에서는 운영 지표가 가장 먼저 측정되는 지표인 경우가 많습니다. 이는 API 성능에 대한 통찰력을 제공하는 전술적 측정항목입니다. 운영 지표는 일반적으로 KPI가 아닙니다. 하지만 팀이 구축한 소프트웨어의 품질과 성능을 측정하고 새로운 문제에 대한 초기 지표를 제공하거나 주요 KPI에 영향을 미칠 수 있는 문제를 드릴다운하고 찾아내는 데 도움이 될 수 있습니다.

팀과 책임을 기반으로 다양한 운영 지표를 추적할 수 있습니다.

인프라팀

플랫폼 운영 팀은 다양한 팀에서 애플리케이션을 제공하기 위해 사용하는 인프라와 기술 포트폴리오를 유지 관리, 연결 및 보호합니다. API 프로그램의 경우 일반적으로 API 게이트웨이 및 API 개발자 포털이 포함됩니다.

플랫폼 운영과 같은 인프라 팀의 주요 지표는 다음과 같습니다.

가동 시간 – 가장 기본적인 지표 중 하나인 가동 시간은 서비스 가용성을 측정하는 최고의 표준입니다. 이는 종종 서비스 수준 계약 (SLA)과 연관됩니다.
CPU 및 메모리 사용량 - API 게이트웨이의 리소스 사용량을 추적하는 것은 인스턴스를 확장해야 하는 시기를 결정하는 데 중요합니다. 또한 오류가 임박했거나 오류로 인한 사용량 급증에 대한 조기 경고 표시기 역할을 할 수도 있습니다.
전체 통과 및 오류율 - API가 HTTP 오류 상태 코드( 아님 200)를 트리거하는 빈도를 측정하면 API가 얼마나 오류가 발생하기 쉬운지 이해하는 데 도움이 됩니다. 이 복합 지표는 팀이 프로덕션에 투입하는 API의 전반적인 품질을 판단하는 데 도움이 되는 정보를 제공합니다.

응용팀

애플리케이션 팀은 각 서비스나 애플리케이션의 구축과 운영을 담당하는 API 개발자와 서비스 소유자로 구성됩니다. 이러한 서비스 또는 애플리케이션은 더 큰 제품의 일부로 사용되거나, 파트너 제품과 통합되거나, 개발자에게 API를 서비스로 제공하는 데 사용될 수 있습니다.

애플리케이션 팀은 다음 측정항목을 측정해야 합니다.

분당 요청 – 이 성능 지표는 API가 분당 처리하는 요청 수를 측정합니다. 시간이 지남에 따라 변경되지만 일반적으로 API 사용자에게 최상의 경험을 보장하기 위해 분당 요청 수를 제한하는 것이 좋습니다.
평균 및 최대 지연 시간 – API가 요청을 수신하고 응답을 반환하는 데 걸리는 평균 시간을 추적하는 것이 중요합니다. 느린 API는 사용자 경험에 부정적인 영향을 미칠 수 있으며, 이는 결국 비즈니스에도 부정적인 영향을 미칠 수 있습니다.
분당 오류 - 진실은 종종 동일합니다. 완벽한 API는 없습니다. 조만간 실수는 불가피합니다. 오류가 갑자기 확대되기 전에 가능한 한 빨리 오류를 수정하기 위해 오류를 모니터링하고 잘 계획된 조치 과정을 구현해야 합니다.

API 운영과 비즈니스에 중요한 KPI 및 지표에 대해 더 깊이 이해하려면 O'Reilly 전자책 Mastering API Architecture by NGINX 의 3~5장을 참조하세요 .

채택 지표

API 우선 기업은 개발자가 API와 상호 작용하는 방식을 이해하기 위해 엔지니어링 지표를 넘어서야 합니다. 또한 개발자가 API를 채택하고 그로부터 가치를 얻고 있는지 확인하려면 API 개발자 경험을 측정하고 모니터링해야 합니다 .

다음은 지표 사용의 몇 가지 예입니다.

고유한 API 소비자 – 이 지표는 일반적으로 월별 활성 사용자 수를 통해 API를 사용하는 개발자 수를 측정합니다. 이상적으로는 더 많은 개발자가 API를 자신의 애플리케이션에 통합할수록 이 측정항목이 커집니다.
API 사용량 증가 - 이 지표는 API 채택도 측정하며 API 채택을 측정하는 데 선호되는 지표인 경우가 많습니다. 이상적으로는 더 많은 애플리케이션과 개발자가 API를 사용함에 따라 API 트래픽이 매달 증가할 것입니다.
첫 번째 호출까지의 시간 – 이 지표는 개발자가 계정을 생성하고, API 자격 증명을 생성하고, 첫 번째 API 호출을 실행하는 데 걸리는 시간을 측정합니다. 개발자를 가능한 한 빨리 시작하고 실행하는 것이 최우선이므로 이 측정항목은 전체 API 개발자 경험에 대한 가장 중요한 측정항목입니다.

참고: KPI 측정 API를 하나 이상 채택하는 것이 좋습니다. 이는 API 프로그램의 전반적인 성장을 예측하는 데 도움이 됩니다. 예를 들어 지속적인 통합이나 앱을 만들기 위해 API를 사용하는 개발자 수의 증가를 추적하도록 KPI를 설정할 수 있습니다.

제품 지표

API 제품 지표는 API의 가치를 이해하는 데 중요한 역할을 합니다. API의 작은 하위 집합만이 직접적인 수익 기여를 가져올 수 있지만 각 API는 비즈니스 가치를 창출해야 합니다.

측정할 주요 제품 지표는 다음과 같습니다.

직접 및 간접 수익 – 이 지표는 API가 수익에 기여하는 다양한 방식을 측정합니다. 이러한 API 중 일부는 직접 수익을 창출할 수 있고 다른 일부는 비즈니스 파트너 제품과의 통합 또는 고객에게 중요한 타사 통합을 지원합니다. API 채택 추적과 마찬가지로 간접 수익 추적은 개발자가 파트너를 위한 수익 창출 애플리케이션을 구축하는 데 도움이 됩니다.
API당 애플리케이션 수 – API는 재사용 가능해야 합니다. 이 지표는 어떤 API가 가장 많은 가치를 창출하는지 이해하기 위해 API와 통합된 애플리케이션 수를 측정합니다.
파트너 수 – API를 사용하면 비즈니스 관계 구축이 가능한 경우가 많습니다. 파트너의 API 통합 수를 추적하면 채택을 유도하고 다른 사업부에 가치를 입증하는 데 도움이 될 수 있습니다.

참고: 이러한 제품 지표는 비즈니스 영향과 밀접한 관련이 있습니다. 비즈니스 목표에 따라 일부 제품 지표를 KPI로 변환하도록 선택할 수 있습니다. 예를 들어 API 전략의 비즈니스 목표가 타사 공급자를 통해 더 많은 고객에게 다가가는 것이라면 API를 사용하는 파트너 수와 이러한 통합을 통해 생성된 간접 수익을 추적할 수 있습니다.

비즈니스 및 운영 KPI를 포함하여 API 제품의 수명주기에 대한 더 깊은 이해를 보려면 "API 아키텍처 마스터하기" 의 3~5장을 참조하세요 .

결론

API 지표와 비즈니스 KPI의 상관 관계는 기업이 데이터 기반 결정을 내리고 API 전략이 필요한 가치를 제공할 수 있도록 하는 주요 방법 중 하나입니다. 또한 API 가시성을 활성화하면 인프라 및 애플리케이션 팀이 각자에게 가장 중요한 운영 지표를 측정하는 데 도움이 됩니다.

NGINX를 사용하면 수십 개의 중요한 API 지표를 시각화할 수 있습니다. 실시간 및 기록 지표를 확인하고 이를 선호하는 애플리케이션 성능 모니터링(또는 APM) 또는 데이터 분석 솔루션으로 쉽게 내보낼 수 있습니다.

NGINX의 유일한 공식 중국어 커뮤니티(모두 nginx.org.cn)

더 많은 NGINX 관련 기술 정보, 대화형 Q&A, 일련의 강좌 및 이벤트 리소스: 오픈 소스 커뮤니티 공식 웹사이트 WeChat 공식 계정 |