opsnote - 초보 인프라 노트

리눅스 서버 운영을 하다 보면 웹 장애가 났을 때 “사이트 안 됩니다”, “접속이 안 돼요”, “nginx 에러 같아요”처럼 너무 크게 뭉뚱그려서 보고하게 될 때가 있습니다. 그런데 실제 장애 대응에서는 HTTP 상태코드, 영향 범위, 재현 여부, 확인한 로그, 추정 원인까지 같이 정리해야 다음 사람이 바로 이어서 볼 수 있습니다. 이번 글에서는 초보 운영자 기준으로 웹 장애를 보고할 때 HTTP 오류 코드를 어떻게 정리하면 좋은지 실무 노트처럼 정리해보겠습니다.왜 HTTP 코드로 정리해서 보고해야 할까웹 장애는 겉으로 비슷해 보여도 실제로는 보는 방향이 다릅니다.예를 들어:403 → 권한이나 접근 정책 문제 가능성404 → 경로, 파일, 라우팅 문제 가능성500 → 애플리케이션 내부 오류 가능성502 ..

리눅스 서버에서 웹 장애가 발생했을 때 브라우저에 403, 404, 500, 502, 503, 504 같은 HTTP 응답 코드가 뜨면 처음에는 다 비슷한 오류처럼 보입니다. 하지만 서버 운영에서는 에러 코드만 잘 봐도 권한 문제인지, 경로 문제인지, 애플리케이션 오류인지, 응답 지연인지 확인 방향을 잡을 수 있습니다. 이번 글에서는 초보 운영자 기준으로 HTTP 상태코드별 확인 순서를 정리해보겠습니다.HTTP 응답 코드를 먼저 봐야 하는 이유장애가 났을 때 초보 운영자는 보통 이렇게 생각하기 쉽습니다.사이트가 안 된다서버가 죽은 것 같다nginx 재기동해야 하나?방화벽 문제인가? 하지만 HTTP 코드를 보면 처음부터 조금 더 좁혀서 볼 수 있습니다.403 → 접근이 막힘404 → 경로를 못 찾음500 →..

리눅스 서버에서 504 Gateway Timeout 오류가 뜨면 nginx나 웹서버가 죽은 것처럼 보일 수 있습니다. 하지만 서버 운영 중 만나는 504 오류는 앞단 웹서버가 뒤쪽 WAS나 애플리케이션 서버의 응답을 기다리다가 시간이 초과될 때 자주 발생합니다. 이번 글에서는 504 오류가 났을 때 바로 재기동하지 않고, 응답 지연, 애플리케이션 로그, DB 지연, timeout 설정을 어떤 순서로 확인하면 안전한지 정리해보겠습니다.504 Gateway Timeout은 무슨 뜻일까?504 Gateway Timeout은 앞단 서버가 뒤쪽 서버의 응답을 기다렸지만, 정해진 시간 안에 응답을 받지 못했다는 뜻입니다.예를 들면 이런 흐름입니다.사용자→ nginx→ WAS 또는 애플리케이션→ DB 또는 외부 AP..

리눅스 서버에서 503 Service Unavailable 오류가 뜨면 웹서버나 nginx 문제처럼 보일 수 있습니다. 하지만 서버 운영 중 만나는 503 오류는 뒤쪽 애플리케이션 서비스가 내려갔거나, 포트가 열려 있지 않거나, 배포 중이라 잠시 요청을 받을 수 없는 상태일 때 자주 발생합니다. 이번 글에서는 503 오류가 났을 때 바로 재기동하지 않고, 서비스 상태와 프로세스, 포트, 로그를 어떤 순서로 확인하면 안전한지 정리해보겠습니다.503 Service Unavailable은 무슨 뜻일까?503은 말 그대로 서비스를 사용할 수 없는 상태라는 뜻입니다.404가 “경로를 못 찾음”,403이 “접근이 막힘”,500이 “애플리케이션 내부 오류”에 가깝다면,503은 “서비스가 지금 요청을 받을 준비가 안 ..

리눅스 서버에서 웹페이지나 API 호출 중 500 Internal Server Error가 뜨면 nginx나 Apache 같은 웹서버 문제처럼 보일 수 있습니다. 하지만 서버 운영 중 만나는 500 오류는 앞단 웹서버보다 WAS, 애플리케이션 예외, DB 연결, 설정값 누락, 배포 오류에서 발생하는 경우가 많습니다. 이번 글에서는 500 오류가 났을 때 바로 재기동하지 않고, 애플리케이션 로그와 웹서버 로그를 어떤 순서로 확인하면 안전한지 정리해보겠습니다.500 Internal Server Error는 무슨 뜻일까?500 Internal Server Error는 서버 내부에서 요청을 처리하다가 문제가 생겼다는 뜻입니다.404가 “요청한 경로를 못 찾음”,403이 “접근이 막힘”에 가깝다면,500은 “서버..

리눅스 서버에서 웹페이지 접속 중 403 Forbidden 오류가 뜨면 웹서버가 죽은 건지, 방화벽 문제인지부터 떠올리기 쉽습니다. 하지만 서버 운영 중 만나는 403 오류는 nginx나 Apache 같은 웹서버가 요청은 받았지만, 파일 권한, 디렉터리 권한, location 설정, allow/deny 정책, index 파일 누락 때문에 접근을 막는 경우가 많습니다. 이번 글에서는 403 Forbidden 원인을 확인할 때 바로 재기동하거나 chmod부터 하지 않고, 어떤 순서로 보면 안전한지 정리해보겠습니다.403 Forbidden은 무슨 뜻일까?403 Forbidden은 말 그대로 접근이 금지되었다는 뜻입니다.404가 “요청한 대상을 찾지 못함”에 가깝다면,403은 “요청한 대상이 있거나 경로는 맞는..

리눅스 서버에서 웹페이지 접속 중 HTTP 502 Bad Gateway 오류가 뜨면 처음에는 nginx 설정 문제처럼 보일 수 있습니다. 하지만 실제 운영 서버에서는 nginx 자체보다 뒤쪽 WAS, 애플리케이션, 포트, upstream 연결 문제 때문에 502가 발생하는 경우가 많습니다. 이번 글에서는 502 오류가 났을 때 바로 nginx 재기동부터 하지 않고, 어떤 순서로 확인하면 안전한지 정리해보겠습니다.502 Bad Gateway는 무슨 뜻일까?502 Bad Gateway는 쉽게 말하면 앞단 서버가 뒤쪽 서버와 제대로 통신하지 못했다는 뜻입니다.예를 들어 사용자가 브라우저로 접속하면 흐름은 대략 이렇게 이어질 수 있습니다.사용자 브라우저 ↓nginx ↓WAS 또는 애플리케이션 서버이때 ngi..