2025-04-08T19:56:24

docs/actuator/01_actuator.md

@@ -0,0 +1,98 @@
+좋아, 1부 "개요와 시작"을 간결하게 작성해볼게. 실무자가 빠르게 이해하고 따라 할 수 있도록 구성하고, 예시는 Gradle 기준으로 쓸게.
+
+---
+
+## **1부. 개요와 시작**
+
+---
+
+### **1장. 스프링 부트 액추에이터란?**
+
+#### 액추에이터의 개요
+
+- 스프링 부트 액추에이터(Spring Boot Actuator)는 애플리케이션의 상태, 성능, 메트릭, 로그 설정 등을 HTTP 엔드포인트로 노출하여 운영·모니터링을 쉽게 할 수 있도록 도와주는 기능이다.
+
+#### 주요 기능
+
+- Health 체크
+- 애플리케이션 정보 출력
+- 메트릭 수집 (CPU, 메모리, 요청 수 등)
+- HTTP 요청 추적
+- 로깅 레벨 변경
+- 사용자 정의 엔드포인트 구현
+
+---
+
+### **2장. 프로젝트 설정**
+
+#### Gradle 설정 예시
+
+```kotlin
+dependencies {
+    implementation 'org.springframework.boot:spring-boot-starter-actuator'
+    implementation 'org.springframework.boot:spring-boot-starter-web'
+}
+```
+
+#### 애플리케이션 실행
+
+```bash
+./gradlew bootRun
+```
+
+실행 후 `http://localhost:8080/actuator` 접속
+
+---
+
+### **3장. 기본 엔드포인트 살펴보기**
+
+#### 엔드포인트 목록
+
+- `/actuator/health` – 애플리케이션 상태 확인
+- `/actuator/info` – 앱 정보 출력
+- `/actuator/metrics` – 메트릭 데이터
+- `/actuator/loggers` – 로깅 레벨 제어
+- `/actuator/beans` – 빈 목록 출력
+- `/actuator/env` – 환경 변수 출력
+
+#### application.yml 설정 예시
+
+```yaml
+management:
+  endpoints:
+    web:
+      exposure:
+        include: "*"
+```
+
+> 기본적으로 대부분의 엔드포인트는 비공개이며, 위 설정으로 전체 노출 가능.
+
+---
+
+### **4장. 엔드포인트 테스트하기**
+
+#### curl로 확인
+
+```bash
+curl http://localhost:8080/actuator/health
+```
+
+#### 결과 예시
+
+```json
+{
+  "status": "UP"
+}
+```
+
+---
+
+### **5장. 요약**
+
+- 액추에이터는 스프링 부트에서 운영 편의성을 높이는 핵심 도구다.
+- 별도 서버 설치 없이 엔드포인트를 통해 상태, 성능, 설정 정보를 쉽게 확인할 수 있다.
+- Gradle로 간단히 의존성을 추가하고, `application.yml`로 노출 설정을 제어할 수 있다.
+
+---
+
+원하면 각 장에 더 많은 설명이나 예제를 추가해줄 수 있어. 다음은 2부 주요 엔드포인트 설명 들어가면 좋을 것 같아. 계속 이어서 쓸까?