다음을 통해 공유


Azure API Management에서 캐싱을 추가하여 성능 향상

적용 대상: 개발자 | 기본 | 기본 v2 | 표준 | 표준 v2 | 프리미엄 | 프리미엄 v2

API Management의 API 및 작업은 응답 캐싱을 사용하여 구성할 수 있습니다. 응답 캐싱은 API 호출자의 대기 시간과 API 공급자의 백 엔드 부하를 크게 줄일 수 있습니다.

Important

기본 제공 캐시는 휘발성이며 동일한 API Management 서비스의 동일한 지역에 있는 모든 유닛에서 공유됩니다. 사용 중인 캐시 유형(내부 또는 외부)에 관계없이 캐시 관련 작업이 캐시의 변동성 또는 기타 이유로 인해 캐시에 연결되지 않는 경우 캐시 관련 작업을 사용하는 API 호출은 오류를 발생하지 않으며 캐시 작업이 성공적으로 완료됩니다. 읽기 작업의 경우 호출 정책 식에 null 값이 반환됩니다. 정책 코드는 캐시에서 찾을 수 없는 데이터를 검색하는 "대체" 메커니즘이 있는지 확인하도록 설계되어야 합니다. 캐싱에 대한 자세한 내용은 API Management 캐싱 정책과 Azure API Management의 사용자 지정 캐싱을 참조하세요.

캐시 정책

학습할 내용:

  • API에 대한 응답 캐싱 추가
  • 실행 중인 캐싱 확인

참고 항목

내부 캐시는 Azure API Management의 소비 계층에서 사용할 수 없습니다. 그 대신 외부 Azure Cache for Redis를 사용할 수 있습니다. 다른 API Management 서비스 계층에서 외부 캐시를 구성할 수도 있습니다.

필수 조건

이 자습서를 완료하려면 다음이 필요합니다.

캐싱 정책 추가

이 예제에 표시된 캐싱 정책을 사용하면 테스트 작업에 대한 첫 번째 요청이 백 엔드 서비스의 응답을 반환합니다. 이 응답은 지정된 헤더 및 쿼리 문자열 매개 변수를 통해 캐시 및 입력됩니다. 일치하는 매개 변수를 사용하는, 작업에 대한 후속 호출은 캐시 기간 간격이 만료될 때까지 캐시된 응답을 반환합니다.

  1. Azure Portal에 로그인합니다.

  2. API Management 인스턴스로 이동합니다.

  3. 왼쪽 메뉴에서 API API>를 선택합니다.

  4. 캐싱을 구성할 API를 선택합니다.

  5. 화면 맨 위에서 디자인 탭을 선택합니다.

  6. 인바운드 처리 섹션에서 </> 아이콘을 선택합니다. 포털의 API Management 정책 편집기 스크린샷

  7. 요소에서 inbound 다음 정책을 추가합니다.

    <cache-lookup vary-by-developer="false" vary-by-developer-groups="false">
        <vary-by-header>Accept</vary-by-header>
        <vary-by-header>Accept-Charset</vary-by-header>
        <vary-by-header>Authorization</vary-by-header>
    </cache-lookup>
    
  8. 요소에서 outbound 다음 정책을 추가합니다.

    <cache-store duration="20" />
    

    이 정책 에서 기간 은 캐시된 응답의 만료 간격을 지정합니다. 이 예제에서는 간격이 20초입니다.

Azure API Management에서 Azure Cache for Redis 사용에서 설명한 대로 외부 캐시를 사용하는 경우 캐싱 정책의 caching-type 특성을 지정할 수 있습니다. 자세한 내용은 API Management 캐싱 정책을 참조하세요.

작업 호출 및 캐싱 테스트

작동 중인 캐싱을 보려면 포털에서 작업을 호출합니다.

  1. Azure Portal에서 API Management 인스턴스로 이동합니다.
  2. 왼쪽 메뉴에서 API API>를 선택합니다.
  3. 캐싱 정책을 추가할 API를 선택합니다.
  4. 테스트할 작업을 선택합니다.
  5. 오른쪽 위 메뉴에서 테스트 탭을 선택합니다.
  6. 빠른 연속으로 추적을 2~3번 선택합니다.
  7. HTTP 응답에서 추적 탭을 선택합니다.
  8. 인바운드 섹션으로 이동하여 정책으로 스크롤합니다cache-lookup. 다음 스크린샷에 캐시 적중을 나타내는 것과 유사한 메시지가 표시됩니다. 포털에서 API를 테스트할 때의 캐시 조회 스크린샷