성공적인 API 전략을 위해 모니터링해야 할 12가지 지표

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

일반적으로 KPI는 특정 목표에 연결됩니다. KPI는 정의된 시간 프레임을 가지고 있으며 API 전략이 제공해야 하는 결과에 맞춰져 있습니다. 반면 API 메트릭은 중요한 데이터 포인트입니다. 모든 메트릭이 KPI는 아니지만 모든 KPI는 메트릭으로 시작합니다.

그럼, 어떻게 시작해야 할까요? 먼저, API 전략의 목표를 처음부터 명확히 한 다음, 그 목표에 맞는 지표를 선택해야 합니다. 각 팀은 무엇이 중요한지, 무엇이 비즈니스에 필수적인지에 따라 다른 지표를 측정하고 추적해야 한다는 점을 기억하세요.

대체로 기업이 추적할 수 있는 API 지표에는 세 가지 주요 유형이 있으며, 각 유형은 다른 질문에 답합니다.

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

이러한 포괄적인 지표를 피라미드로 상상해 보세요. 맨 아래에 있는 운영 지표는 개별 API와 이를 지원하는 인프라의 전술적 성과를 측정합니다. 맨 위에 있는 제품 지표는 API가 창출한 비즈니스 가치를 측정합니다. 이 둘은 채택 지표로 연결되어 있으며, 채택 지표는 최종 사용자(개발자)와 함께 API 프로그램의 성장을 추적합니다. 일반적으로 제품 지표와 채택 지표는 측정해야 하는 비즈니스 성과와 일치하는 반면, 운영 지표는 유지해야 하는 기술 표준과 일치합니다.

이 게시물에서는 측정이 중요한 12가지 구체적인 지표를 분석하고, 이러한 지표가 인프라 및 애플리케이션 팀을 지원하는 방식을 논의하며, 이러한 지표가 KPI와 관련되는 방식을 설명합니다.

운영 지표

방금 시작했을 때, 운영 지표는 일반적으로 가장 먼저 측정해야 할 사항입니다. 운영 지표는 전술적이며 API가 어떻게 기능하는지에 대한 통찰력을 제공합니다. 운영 지표 자체는 일반적으로 KPI가 아닙니다. 대신, 팀이 구축하는 소프트웨어의 품질과 성능을 측정하는 데 도움이 됩니다. 새로운 문제에 대한 초기 지표를 제공하거나, 중요한 KPI에 영향을 미칠 수 있는 문제를 자세히 조사하여 발견하는 데 도움이 될 수 있습니다.

추적하는 운영 지표는 팀과 책임에 따라 달라집니다.

인프라 팀

Platform Ops 는 다양한 팀이 애플리케이션을 제공하는 데 사용하는 인프라와 기술 컬렉션을 유지 관리, 연결 및 보호하는 일을 담당하는 팀입니다. API 프로그램의 경우 여기에는 종종 API 게이트웨이와 API 개발자 포털이 포함됩니다.

Platform Ops와 같은 인프라 팀의 주요 지표는 다음과 같습니다.

1. 가동 시간  – 가장 기본적인 지표 중 하나이기는 하지만 가동 시간은 서비스 가용성을 측정하는 데 있어 황금 표준입니다. 이는 종종 서비스 수준 계약 (SLA)과 관련이 있습니다.
2. CPU 및 메모리 사용  – API 게이트웨이에서 리소스 사용률을 추적하는 것은 인스턴스를 확장해야 할 시점을 식별하는 데 중요합니다. 또한 무언가가 망가지기 시작하거나 오류로 인해 사용량이 급증할 때 조기 경고 역할을 합니다.
3. 총 통과율 및 오류율  – API가 HTTP 오류(비‑) 상태 코드를 트리거하는 빈도를 측정하면 200API가 얼마나 오류가 발생하기 쉬운지 이해하는 데 도움이 됩니다. 이 집계 측정값은 팀이 프로덕션에 투입하는 API의 전반적인 품질을 판단하는 데 도움이 되는 정보를 제공합니다.

응용 프로그램 팀 (Application 팀)

API 개발자와 서비스 소유자로 구성된 애플리케이션 팀은 개별 서비스나 애플리케이션을 빌드하고 운영할 책임이 있습니다. 이는 더 큰 제품의 일부로 사용되거나, 파트너와 통합되거나, 개발자에게 API를 서비스로 제공할 때 사용될 수 있습니다.

애플리케이션 팀이 측정하는 데 중요한 지표는 다음과 같습니다.

4. 분당 요청 수  – 이 성능 지표는 API가 처리하는 요청 수를 측정합니다. 시간이 지남에 따라 달라지지만 일반적으로 API 사용자에게 최상의 경험을 보장하기 위해 하향적으로 관리하고 싶을 것입니다.
5. 평균 및 최대 지연 시간  – API가 요청을 수신하고 응답을 반환하는 데 걸리는 평균 시간을 추적하는 것은 매우 중요합니다. 느린 API 하나가 사용자 경험에 부정적인 영향을 미칠 수 있으므로 비즈니스에 부정적인 영향을 미칩니다.
6. 분당 오류  - 다른 모든 것과 마찬가지로 어떤 API도 완벽하지 않습니다. 실패는 언제 발생하는지 여부가 아니라 언제 발생하는지의 문제입니다. 오류를 모니터링하고 갑자기 오류가 발생하기 전에 오류를 수정하기 위한 계획된 조치 과정을 마련해야 합니다.

O'Reilly에서 NGINX를 바탕으로 출간 한 전자책 'API 아키텍처 마스터 링 '의 3~5장에서 API 운영을 심층적으로 살펴보고 비즈니스 관점에서 어떤 KPI와 측정항목이 중요한지 알아보세요 .

채택 지표

API 우선 비즈니스의 경우 엔지니어링 지표를 넘어 개발자가 API와 어떻게 상호 작용하는지 이해하는 것이 필수적입니다. 또한 개발자가 API를 채택하고 가치를 얻고 있는지 확인하기 위해 API 개발자 경험을 측정하고 모니터링해야 합니다.

채택 지표의 몇 가지 예는 다음과 같습니다.

7. 고유 API 소비자  - 종종 월별 사용자로 시간적으로 제한되는 이 지표는 얼마나 많은 개발자가 귀하의 API를 채택하고 사용하는지 측정합니다. 이상적으로 이 지표는 더 많은 개발자가 귀하의 API를 애플리케이션에 통합함에 따라 시간이 지남에 따라 커집니다.
8. API 사용 증가  - 이 지표는 API 채택도 측정하며, 이를 위해 선호되는 지표입니다. 이상적으로는 API 트래픽은 애플리케이션과 이를 사용하는 개발자의 수가 증가함에 따라 매월 증가합니다.
9. 첫 번째 호출 시간  - 이 지표는 개발자가 계정을 만들고, API 자격 증명을 생성하고, 첫 번째 API 호출을 실행하는 데 걸리는 시간을 측정합니다. 개발자가 가능한 한 빨리 시작하고 실행할 수 있도록 하는 것이 최우선 순위이므로 이 지표는 전체 API 개발자 경험을 측정하는 데 가장 중요합니다.

참고: KPI 중 하나 이상이 API 채택을 측정하도록 하는 것이 좋습니다. 이렇게 하면 API 프로그램의 전반적인 성장을 계산하는 데 도움이 됩니다. 예를 들어, API를 사용하여 지속적인 통합 또는 앱을 만든 개발자 수를 늘리기 위해 KPI를 설정할 수 있습니다.

제품 지표

API 제품 메트릭은 API의 가치를 이해하는 데 중요한 역할을 합니다. API의 일부 하위 집합만이 수익에 직접 기여할 수 있지만 모든 API는 비즈니스에 가치를 제공해야 합니다.

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

10. 직접 및 간접 수익  – 이러한 지표는 API가 수익에 기여하는 다양한 방식을 대상으로 합니다. 일부 API는 직접 수익화되는 반면, 다른 API는 비즈니스 파트너와의 통합을 지원하거나 고객이 중시하는 타사 통합입니다. API 채택률과 마찬가지로 간접 수익을 추적하면 개발자가 파트너를 위해 수익을 창출하는 앱을 구축하는 데 도움이 됩니다.
11. API당 애플리케이션  - API는 재사용 가능해야 합니다. 이 지표는 API와 통합되는 애플리케이션의 수를 측정하여 어떤 API가 가장 많은 가치를 제공하는지 확인합니다.
12. 파트너 수  – API는 종종 비즈니스 관계를 가능하게 합니다. 파트너 API 통합 수를 추적하면 채택을 촉진하고 다른 사업부에 가치를 입증하는 데 도움이 됩니다.

참고: 이러한 제품 메트릭은 비즈니스 영향과 긴밀하게 연관되어 있으며, 비즈니스 목표에 따라 일부를 KPI로 전환할 수 있습니다. 예를 들어, API 전략의 비즈니스 목표가 타사 공급업체를 통해 더 많은 고객에게 도달하는 것이라면 API를 사용하는 파트너 수와 해당 통합을 통해 생성된 간접 수익을 모두 추적해야 합니다.

API 아키텍처 마스터링 의 3~5장에서 비즈니스 및 운영 KPI를 포함한 API 제품 수명 주기를 더 자세히 살펴보세요 .

결론

API 지표와 비즈니스 KPI를 정렬하는 것은 데이터 중심 의사 결정을 내리고 API 전략이 조직에 필요한 가치를 제공하도록 하는 주요 방법 중 하나입니다. 그뿐만 아니라 API에 대한 가시성을 확보하면 인프라 및 애플리케이션 팀이 가장 중요한 운영 지표를 측정할 수 있습니다.

NGINX에서는 수십 개의 중요한 API 메트릭에 대한 가시성을 제공합니다. 실시간 및 과거 메트릭을 보고, 선호하는 애플리케이션 성능 모니터링(APM) 또는 데이터 분석 솔루션으로 쉽게 내보낼 수 있습니다.