API 지표 어떻게 모니터링하고 관리하고 계신가요?

일반적으로 KPI는 특정 목표와 연결되어 있습니다. 정의된 시간 범위가 있으며 API 전략이 제공해야 하는 결과에 맞춰 조정됩니다. 반대로 API 지표 는 중요한 데이터 포인트입니다. 모든 Metrics이 KPI는 아니지만 모든 KPI는 Metrics으로 시작됩니다.

기업이 Modern 애플리케이션을 구축하기 위해 API-First 설계를 채택함에 따라 해당 API의 운영 성능과 가치를 측정하는 것이 최우선 순위가 되었습니다. API Key Performance Indicators(KPI)를 명확하게 정의하고 연결하는 프레임워크를 설정하는 것은 성공적인 API 전략을 보장하기 위한 가장 중요한 단계 중 하나입니다.

어떻게 시작할까요? 먼저, 처음부터 API 전략의 목표를 명확히 한 다음 해당 목표에 부합하는 Metrics를 선택해야 합니다. 각 팀은 자신에게 중요한 것과 비즈니스에 필수적인 것에 따라 서로 다른 Metrics를 측정하고 추적해야 합니다.

일반적으로 기업이 추적할 수 있는 API Metrics에는 크게 세 가지 유형이 있으며 각 유형은 서로 다른 질문에 답합니다:

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

이러한 중요한 Metrics를 피라미드로 상상해 보십시오. 맨 아래에서 운영 Metrics는 개별 API와 이를 지원하는 인프라의 전술적 성능을 측정합니다. 맨 위에 있는 Product Metrics는 API로 생성된 비즈니스 가치를 측정합니다. 이 둘은 최종 사용자(개발자)와 함께 API 프로그램의 성장을 추적하는 채택 Metrics로 연결됩니다. 일반적으로 Product Metrics와 채택 Metrics는 측정해야 하는 비즈니스 결과에 맞춰 조정되며, 운영 Metrics는 유지 관리해야 하는 기술 표준에 맞춰 조정됩니다.

이 포스트에서는 측정에 중요한 12가지 특정 API 지표를 분석하고 인프라 및 애플리케이션팀을 지원하는 방법에 대해 논의하며 Metrics가 KPI와 관련된 방법에 대해 설명합니다.

목차

1. 운영 API 지표 (Metrics)
 1-1. 인프라팀
1-2. 애플리케이션팀
2. 채택 API 지표 (Metrics)
3. Product API 지표 (Metrics)
4. API 지표 결론

1. 운영 API 지표 (Metrics)

이제 막 시작할 때는 일반적으로 운영 Metrics를 가장 먼저 측정해야 합니다. 전술적이며 API가 작동하는 방식에 대한 통찰력을 제공합니다. 운영 Metrics는 일반적으로 KPI 자체가 아닙니다. 대신 팀이 구축하고 있는 소프트웨어의 품질과 성능을 측정하는 데 도움이 됩니다. 새로운 문제에 대한 초기 지표를 제공하거나 중요한 KPI에 영향을 미칠 수 있는 문제를 파악하고 발견하는 데 도움을 줄 수 있습니다.

추적하는 운영 API 지표 (Metrics)는 팀과 책임에 따라 다릅니다.

1-1. 인프라팀

Platform Ops는 다양한 팀이 애플리케이션을 제공하기 위해 사용하는 인프라 및 기술 모음을 유지 관리, 연결 및 보호하는 팀입니다. API 프로그램의 경우 여기에는 종종 API Gateway 및 API 개발자 포털이 포함됩니다.

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

  • Uptime – 가장 기본적인 Metrics 중 하나인 Uptime은 서비스 가용성을 측정하기 위한 최고의 표준입니다. 이는 종종 Service Level Agreement(SLA)과 연결됩니다.
  • CPU 및 메모리 사용량 – API Gateway에서 리소스 사용률을 추적하는 것은 인스턴스를 확장해야 하는 시기를 식별하는 데 중요합니다. 또한 무언가가 중단되기 시작하거나 오류로 인해 사용량이 급증할 때 조기 경고 역할을 합니다.
  • 총 Pass 및 Error 율 (Total pass and error rates) – API가 HTTP 오류(200이 아닌) 상태 코드를 Trigger하는 빈도를 측정하면 API의 오류 발생 가능성을 파악하는 데 도움이 됩니다. 이 집계 측정은 팀이 Production에 투입하는 API의 전반적인 품질을 판단하는 데 도움이 되는 정보를 제공합니다.

1-2. 애플리케이션팀

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

다음 Metrics는 애플리케이션팀이 측정하는 데 중요합니다:

  • 분당 요청 수 (Requests per minute) – 이 성능 Metrics는 API가 처리하는 요청 수를 측정합니다. 시간이 지남에 따라 달라지지만 일반적으로 API 사용자에게 최상의 환경을 제공하기 위해 하향 관리하려고 합니다.
  • 평균 및 최대 지연 시간 (Average and maximum latency) – API가 요청을 수신하고 응답을 반환하는 데 걸리는 평균 시간을 추적하는 것은 중요합니다. 느린 API 하나가 사용자 경험에 부정적인 영향을 미칠 수 있으므로 비즈니스에도 부정적인 영향을 미칠 수 있습니다.
  • 분당 오류 수 (Errors per minute) – 다른 모든 것과 마찬가지로 완벽한 API는 없습니다. 실패는 경우가 아니라 시기의 문제입니다. 오류를 모니터링하고 오류를 수정하기 위한 계획된 조치 과정을 마련해야 합니다.

2. 채택 API 지표 (Metrics)

API‑First Business의 경우 엔지니어링 Metrics를 넘어 개발자가 API와 상호 작용하는 방식을 이해하는 것이 중요합니다. 또한 개발자가 API를 채택하고 가치를 얻을 수 있도록 API 개발자 경험(DX)을 측정하고 모니터링해야 합니다.

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

  • 고유한 API Consumers – 이 Metrics는 종종 월별 사용자로 시간이 제한되며 API를 채택하고 사용하는 개발자 수를 측정합니다. 이 Metrics는 더 많은 개발자가 API를 애플리케이션에 통합함에 따라 시간이 지남에 따라 증가합니다.
  • API 사용량 증가 – 또한 이 Metrics는 API 채택을 측정하며 이를 위해 선호되는 Metrics입니다. API 트래픽은 애플리케이션과 이를 사용하는 개발자의 수가 증가함에 따라 매월 증가하는 것이 이상적이다.
  • Time to first call – 이 Metrics는 개발자가 계정을 만들고 API 자격 증명을 생성하고 첫 번째 API 호출을 실행하는 데 걸리는 시간을 측정합니다. 개발자가 가능한 한 빨리 시작하고 실행할 수 있도록 하는 것이 최우선 순위이므로 이 Metrics는 전반적인 API 개발자 경험을 측정하는 데 가장 중요합니다.

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

3. Product API 지표 (Metrics)

API Product Metrics는 API의 가치를 이해하는 데 중요한 역할을 합니다. API의 일부만 수익에 직접적으로 기여할 수 있지만 모든 API는 비즈니스에 가치를 제공해야 합니다.

측정할 주요 Product Metrics는 다음과 같습니다:

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

Note: 이러한 Product Metrics는 비즈니스 영향과 밀접하게 일치하며 비즈니스 목표에 따라 일부를 KPI로 전환하도록 선택할 수 있습니다. 예를 들어 API 전략의 비즈니스 목표가 타사 제공 업체를 통해 더 많은 고객에게 도달하는 것이라면 API를 사용하는 파트너 수와 이러한 통합을 통해 생성된 간접 수익을 모두 추적하려고 합니다.

4. API 지표 결론

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

NGINX Plus에서는 수십 가지 중요한 API 지표 에 대한 가시성을 제공합니다. 실시간 및 기록된 Metrics를 보고 선호하는 애플리케이션 성능 모니터링(APM) 또는 데이터 분석 솔루션으로 쉽게 내보낼 수 있습니다.

NGINX Plus와 함께 API를 배포 테스트 및 사용해 보려면 지금 30일 무료 평가판을 신청하거나 사용 사례에 대해 최신 소식을 빠르게 전달받고 싶으시면 아래 뉴스레터를 구독하세요.