systemctl 명령어 사용법

서비스 실행 여부 한 단어로 확인

$ systemctl is-active sshd.service

active

서비스가 현재 동작 중인지 active/inactive/failed 중 하나로 확인합니다. 동작 중이면 종료 코드 0, 그 외에는 0이 아닌 값을 반환하므로 스크립트 조건문에 쓰기 좋습니다. 실습 컨테이너에서는 실행되지 않는 명령이라 대표 출력을 표시했습니다.

실패한 유닛만 골라 보기

$ systemctl --failed --no-pager

UNIT          LOAD   ACTIVE SUB    DESCRIPTION
● httpd.service loaded failed failed The Apache HTTP Server

LOAD   = Reflects whether the unit definition was properly loaded.
ACTIVE = The high-level unit activation state, i.e. generalization of SUB.
SUB    = The low-level unit activation state, values depend on unit type.

1 loaded units listed. Pass --all to see loaded but inactive units, too.
To show all installed unit files use 'systemctl list-unit-files'.

장애 초동 대응의 첫 단계로, 부팅 이후 실패 상태인 유닛만 추려 봅니다. 실패한 유닛이 없으면 '0 loaded units listed.' 로 표시됩니다. 실습 컨테이너에서는 실행되지 않는 명령이라 대표 출력을 표시했습니다.

서비스 상태와 최근 로그 확인

$ systemctl status httpd.service --no-pager

● httpd.service - The Apache HTTP Server
   Loaded: loaded (/usr/lib/systemd/system/httpd.service; enabled; vendor preset: disabled)
   Active: failed (Result: exit-code) since Tue 2026-09-15 10:21:03 KST; 2min ago
     Docs: man:httpd.service(8)
  Process: 1842 ExecStart=/usr/sbin/httpd $OPTIONS -DFOREGROUND (code=exited, status=1/FAILURE)
 Main PID: 1842 (code=exited, status=1/FAILURE)

Sep 15 10:21:03 web01 httpd[1842]: AH00526: Syntax error on line 12 of /etc/httpd/conf/httpd.conf
Sep 15 10:21:03 web01 systemd[1]: httpd.service: Main process exited, code=exited, status=1/FAILURE
Sep 15 10:21:03 web01 systemd[1]: httpd.service: Failed with result 'exit-code'.

활성 상태, 자동시작 설정, 메인 PID, 종료 코드와 최근 로그 몇 줄을 한 번에 봅니다. 유닛이 실패 상태이면 status 자체의 종료 코드는 3이 되며, 이는 정상적인 동작입니다. 실습 컨테이너에서는 실행되지 않는 명령이라 대표 출력을 표시했습니다.

서비스 유닛 목록에서 특정 서비스 찾기

$ systemctl list-units --type=service --all --no-pager | grep -E 'sshd|httpd'

● httpd.service   loaded    failed failed   The Apache HTTP Server
  sshd.service    loaded    active running OpenSSH server daemon

로드된 서비스 유닛 전체에서 원하는 서비스만 걸러 상태를 비교합니다. 일치하는 줄이 없으면 grep이 종료 코드 1을 반환합니다. 실습 컨테이너에서는 실행되지 않는 명령이라 대표 출력을 표시했습니다.

새 유닛 파일 등록 후 반영과 자동시작 설정

준비: printf '[Unit]\nDescription=Health Check\nAfter=network.target\n\n[Service]\nExecStart=/opt/healthcheck/run.sh\nUser=svc\nRestart=on-failure\n\n[Install]\nWantedBy=multi-user.target\n' > /etc/systemd/system/healthcheck.service

$ systemctl daemon-reload && systemctl enable healthcheck.service

Created symlink /etc/systemd/system/multi-user.target.wants/healthcheck.service → /etc/systemd/system/healthcheck.service.

유닛 파일을 /etc/systemd/system 에 둔 뒤 daemon-reload 로 반영하고 enable 로 부팅 자동시작을 등록합니다. [Install] 섹션이 없으면 enable이 실패합니다. 기존 유닛과 이름이 겹치지 않는지 먼저 확인하세요(systemctl cat 유닛명). 실습 컨테이너에서는 실행되지 않는 명령이라 대표 출력을 표시했습니다.