[실습] 많이 검색한 키워드 Top 10을 보여주는 '인기 검색어 기능’ 만들기 - 2

JSCODE 박재성

2026. 02. 25.

✅ 구현 방법

• 인기 검색어 조회 API에서는 인기순으로 검색어를 정렬해야 하기 때문에, 자동 정렬을 해주는 자료구조인 Sorted Set을 활용한다.

• 검색을 할 때마다 score를 1 증가시킴으로써 인기 검색어를 구분한다.

✅ 실습

1. 코드 작성하기
SearchService

@Service
@RequiredArgsConstructor
public class SearchService {

    private final SearchRepository searchRepository;
    private final RedisTemplate<String, String> redisTemplate;
    
    ...


    public void searchWithRedis(String keyword) {
      // Redis 명령어에서 'ZINCRBY search_keyword_ranking 1 [keyword]'와 동일
      // ZINCRBY 명령어를 사용하여 해당 keyword의 score를 1 증가시킴
      // (만약 해당 키워드가 존재하지 않으면 새로 추가하고 score를 1로 설정함)
      redisTemplate.opsForZSet()
          .incrementScore("search_keyword_ranking", keyword, 1.0);
    }

    public List<String> getTop10KeywordsWithRedis() {
      // Redis 명령어에서 'ZRANGE [key] [start index] [end index] REV'와 동일
      // REV 옵션을 사용하여 Score가 높은 순(내림차순)으로 0~9번 인덱스 데이터를 조회
      Set<String> topKeywords = redisTemplate.opsForZSet()
          .reverseRange("search_keyword_ranking", 0, 9);

      // Set을 List로 변환하여 반환 (null일 경우 빈 리스트 반환)
      return new ArrayList<>(topKeywords);
    }
}

 
SearchController

@RestController
@RequiredArgsConstructor
@RequestMapping("/search")
public class SearchController {

    private final SearchService searchService;

    ...

    @GetMapping("/redis")
    public void searchWithRedis(@RequestParam String keyword) {
      searchService.searchWithRedis(keyword);
    }

    @GetMapping("/top10/redis")
    public List<String> getTop10KeywordsWithRedis() {
      return searchService.getTop10KeywordsWithRedis();
    }
}

 

2. 서버 실행시키기



 

3. 부하테스트 스크립트 살펴보기
이전에 실행시켰던 스크립트(script_3-1.js)와 코드가 대부분 똑같고, 새로 만든 API에 맞게 주소만 변경해주었다.
scripts/script_3-2.js

import http from 'k6/http';
import {check} from 'k6';
import {randomItem} from 'https://jslib.k6.io/k6-utils/1.2.0/index.js';

export const options = {
  // 가상 유저(VUs) 100명으로 설정
  vus: 100,

  // 테스트를 10초 동안 진행
  duration: '10s',
};

// 검색어 리스트 정의
const keywords = [
  'spring', 'java', 'redis', 'mysql', 'jpa',
  'k6', 'performance', 'test', 'load', 'stress',
  'docker', 'kubernetes', 'aws', 'cloud', 'microservices',
  'python', 'javascript', 'react', 'vue', 'angular'
];

export default function () {
  // 1. 검색 API 호출
  // 랜덤한 키워드 선택
  const keyword = randomItem(keywords);
  
  // 검색 요청
  const searchRes = http.get(`http://localhost:8080/search/redis?keyword=${keyword}`);
  
  check(searchRes, {
    'search status is 200': (r) => r.status === 200,
  });

  // 2. 인기 검색어 조회 API 호출
  const top10Res = http.get('http://localhost:8080/search/top10/redis');
  
  check(top10Res, {
    'top10 status is 200': (r) => r.status === 200,
  });
}

 

3. 부하테스트 진행하기

$ k6 run scripts/script_3-2.js



부하테스트를 해보니 검색 API와 인기 검색어 조회 API의 평균 TPS가 40422로 성능이 눈에 띄게 향상된 걸 확인할 수 있다.

5. 인기 검색어 조회 API가 정말 잘 작동하는 지 테스트해보기

✅ 정리