nc -zv -w 3 pg-api.example.com 443
# 결과: Connection to pg-api.example.com 443 port [tcp/https] succeeded!
# → TCP는 열림. 포트 차단이나 서버 다운은 아님

curl -s -o /dev/null \
  --connect-timeout 3 \
  --max-time 10 \
  -w "@/tmp/curl-format.txt" \
  https://pg-api.example.com/v1/charge

# 결과:
# time_namelookup:    0.003210
# time_connect:       0.045678   ← TCP 연결 45ms, 정상
# time_starttransfer: 10.000000  ← 10초 후 강제 종료 (starttransfer 미도달)
# time_total:         10.001234
# curl: (28) Operation timed out

# 가능한 원인 1: PG사 서버 측 장애
# → PG사 상태 페이지 확인, 다른 엔드포인트 테스트
curl -s -o /dev/null -w "%{http_code}" https://pg-api.example.com/health

# 가능한 원인 2: 특정 IP에서만 차단 (화이트리스트)
# → 서버에서와 로컬에서 같은 명령 실행 후 비교
# → PG사에 서버 출구 IP 화이트리스트 등록 여부 확인

# 가능한 원인 3: 요청 헤더 누락으로 서버가 응답 보류
curl -v --connect-timeout 3 --max-time 10 \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  https://pg-api.example.com/v1/charge

// Node.js: axios 타임아웃 설정
const response = await axios.post(url, data, {
  timeout: 10000,           // 전체 10초 (max-time 역할)
  // axios는 connect-timeout을 별도로 노출하지 않음
  // → httpAgent로 세밀하게 제어 가능
});

// Python: requests 타임아웃 설정 (튜플로 분리 가능)
response = requests.post(url, json=data, timeout=(3, 10))
# (connect_timeout=3초, read_timeout=10초)

# Java Spring: RestTemplate 타임아웃
SimpleClientHttpRequestFactory factory = new SimpleClientHttpRequestFactory();
factory.setConnectTimeout(3000);   // 3초
factory.setReadTimeout(10000);     // 10초

# 애플리케이션 로그 (Spring Boot)
# 09:03:12 ERROR - HikariPool-1 - Connection is not available, request timed out after 30000ms
# 09:03:15 ERROR - Read timed out
# 09:03:18 ERROR - HikariPool-1 - Connection is not available, request timed out after 30000ms

# curl로 직접 테스트하면 바로 응답됨
curl -v --max-time 5 https://api.external-service.com/v1/data
# 200 OK, 123ms

# DB 연결 풀 상태 확인 (HikariCP의 경우)
# 애플리케이션 actuator 엔드포인트로 확인
curl http://localhost:8080/actuator/metrics/hikaricp.connections.active
curl http://localhost:8080/actuator/metrics/hikaricp.connections.pending

# 또는 DB에서 직접 확인
# PostgreSQL
SELECT count(*), wait_event_type, wait_event
FROM pg_stat_activity
WHERE datname = 'mydb'
GROUP BY wait_event_type, wait_event;

# 연결 풀 크기 조정 (application.yml)
spring:
  datasource:
    hikari:
      maximum-pool-size: 20      # 기본값 10 → 늘림
      connection-timeout: 5000   # 5초 (기본 30초에서 줄임)
      idle-timeout: 300000       # 5분

# 근본 원인 파악 — 느린 쿼리가 연결을 오래 붙잡는 경우
# PostgreSQL slow query log 확인
# log_min_duration_statement = 1000  # 1초 이상 쿼리 로깅