하늘속에서IT

[Monitoring] Prometheus 상태 확인과 Linux 서버의 Grafana dashboard 구축(feat. Grafana Dashboards Template)

sggnology — Tue, 14 Jan 2025 22:37:17 +0900

발단

[Monitoring] Prometheus & Grafana 를 사용해 Linux 서버의 상태를 모니터링 해보자(feat. docker compose)

발단 테스트 서버의 상태를 모니터링 할 수 있는 도구를 찾던 도중 예전부터 관심있던 Prometheus 와 Grafana 를 도입하여 상태를 확인하고자 합니다. 추후 재사용 될 수 있으니 docker compose 를 통해

atsky.tistory.com

이전 글에서 docker compose 를 통해 모니터링 환경을 구성해 보았습니다. 그러나 Prometheus 에서 제공하는 PromQL 을 통해 Grafana 에서 dashbaord 를 구성하는 것은 쉬운일이 아닌데요. 따라서, Grafana 에서 제공하는 Dashboards Template 을 사용하여 대중적인 시각화 UI 를 구축하는 부분을 설명하면 어떨까 싶어 글을 남깁니다.

사용법

Grafana 에서 제공하는 템플릿 페이지를 알아보고 모니터링 환경에서 UI 를 어떻게 구축하면 좋을지 알아볼 것입니다.

Grafana Dashboards

Grafana dashboards | Grafana Labs

No results found. Please clear one or more filters.

grafana.com

Grafana 클라우드에서 기록되고 있는 Dashboards 템플릿을 확인할 수 있는 웹사이트입니다. 해당 페이지에서 원하는 템플릿을 선택할 수 있습니다.

우리는 Prometheus 를 통해 데이터를 제공받고 있음으로 해당 페이지 옵션에서 Datasource 를 Prometheus 로 선택하여 검색하여야 합니다. 그렇지 않으면 Grafana Dashbaord 구성시 의도하지 않은 Datasource 를 추가해야 할 염려가 생길 수 있습니다.

Prometheus 확인

Endpoint 를 확인해보면 promehteus.yml 에서 설정한 URL 과 경로로 메트릭을 제공받고 있습니다.
State 는 현재 해당 Target 의 상태를 의미하며, UP 이라고 명시되어 있어야 메트릭을 정상적으로 제공받고 있는 상태가 됩니다.

Grafana 확인

Login

docker-compose.yml 에서 설정한 env 하위에 명시한 ID, PW 계정을 사용하여 로그인 할 수 있습니다. 기본값은 admin/admin 입니다.

Datasource 추가

대시보드에 필요한 메트릭 정보 제공을 위한 연결 정보를 생성하여야 합니다. 사진에 명시된 순서에 맞게 클릭하여 검색한후 목록에서 `Prometheus` 를 선택하여주세요.

우측 상단의 `Add new data source` 를 통해 datasource 생성 페이지로 진입합니다.

Name 은 임의로 설정하시면 됩니다.
Connection 에 http://prometheus:9090 을 입력한뒤, 페이지 스크롤을 아래로 내려 `Save & Test` 버튼을 클릭하여 동작하는지 확인하시면 됩니다.
- prometheus:9090 와 같이 IP 가 아닌 도메인 호출방식처럼 사용할 수 있는건 docker compose 의 기능중 하나입니다. docker comopse 로 실행된 각 컨테이너는 그들의 컨테이너명 혹은 서비스명을 통해 각 컨테이너로 접근이 가능합니다. 따라서, grafana 서비스 내에서 prometheus 로 위와 같은 URL 로 접근할 수 있게 되는 것 입니다.

Dashboard 추가

Dashboard 페이지로 이동하여 `Import dashboard` 버튼을 통해 진입합니다.

위에서 보는 바와 같이 dashboard 의 특징은 Json 으로 기록되고 저장됩니다. 그리고, Grafana 는 이를 URL 혹은 Json 파일로 Import 를 가능케 합니다. 우리는 linux server 에 대한 모니터링을 할 것 이고 URL 로 진행할 것 임으로임으로 아래 URL 을 입력창에 입력한뒤 `Load` 버튼을 눌러주세요.

https://grafana.com/grafana/dashboards/1860-node-exporter-full/

마지막입니다.

Load 버튼을 누르게 되면 위와 같은 화면으로 진입하게 됩니다.

Name 은 임의로 설정하시면 됩니다.
아래 Prometheus SelectBox 에서 기존에 추가하였던 Datasource 를 선택해주시면 됩니다.
- 테스트 하는 과정에서 두개의 datasource 를 추가하여 datasource 가 두개 존재하는 것으로 보입니다. 예제를 따라하시는 분들은 이미지와 무관하게, 첫번째 prometheus datasource 를 선택하시면 될겁니다.

마침

이상으로 Prometheus 와 Grafna 환경이 준비된 곳에서 어떻게 Dashboard 를 추가할 수 있는지 확인하였습니다. 진행하시면서 원하시는대로 동작하지 않는 부분이 있으면 질문 부탁드립니다. 최대한 빨리 답변 드리겠습니다.

[Monitoring] Docker 와 Prometheus, Grafana 사용해 Linux 서버의 상태 모니터링(feat. docker compose)

sggnology — Tue, 14 Jan 2025 22:04:49 +0900

발단

테스트 서버의 상태를 모니터링 할 수 있는 도구를 찾던 도중 예전부터 관심있던 Prometheus 와 Grafana 를 도입하여 상태를 확인하고자 합니다. 추후 재사용 될 수 있으니 docker compose 를 통해 사용성을 높일 것입니다.

Prometheus

GitHub - prometheus/prometheus: The Prometheus monitoring system and time series database.

The Prometheus monitoring system and time series database. - prometheus/prometheus

github.com

프로메테우스는 오픈소스 모니터링 및 경고 도구로 특히 시계열 데이터(시간 기반의 정보, 예를들어 13:00 요청 갯수 100개, 13:01 요청 갯수 101 개, .. 등 시간에 따른 정보를 기록)를 수집하고 분석하는 데 중점을 두는 시스템입니다. 다양한 특징이 있고 현시점에 활발하게 사용되는 도구로 여기서는 메트릭(하드웨어나 소프트웨어에 대한 성능 측정을 위한 측정 수치)을 수집하는 도구로 사용할 것입니다.

Exporter

GitHub - prometheus/node_exporter: Exporter for machine metrics

Exporter for machine metrics. Contribute to prometheus/node_exporter development by creating an account on GitHub.

github.com

프로메테우스는 데이터 수집을 위해 Exporter 를 사용합니다. Exporter 는 프로메테우스가 메트릭 수집을 위해 사용하는 도구로 메트릭 정보를 os or application 으로 부터 수집하여 제공하는 역할을 합니다. 여기서는 프로메테우스 에서 공식적으로 제공하고 있는 node 로 구현된 exporter 를 사용하여 메트릭을 수집할 것입니다.

(이 글에서는 예제를 위주로 다루고자 하여 프로메테우스와 Exporter 의 자세한 설명은 공식 문서를 참고하여주세요.)

Grafana

GitHub - grafana/grafana: The open and composable observability and data visualization platform. Visualize metrics, logs, and tr

The open and composable observability and data visualization platform. Visualize metrics, logs, and traces from multiple sources like Prometheus, Loki, Elasticsearch, InfluxDB, Postgres and many mo...

github.com

그라파나는 오픈소스 데이터 시각화 및 모니터링 도구로, 다양한 데이터 소스를 연결하여 대시보드 형태로 데이터를 시각화하고 분석할 수 있게 해줍니다. Grafana 는 주로 시계열 데이터를 시각화하고 실시간 모니터링 및 알림 기능을 제공하는데 사용됩니다. 따라서, 데이터를 수집하여 시계열 정보로 기록하는 Promehteus 와 같이 사용할 것 입니다.

사용법

docker compose 를 사용하여 모니터링을 위한 3개의 컨테이너를 같이 구성하여 사용성을 높이고자 합니다.(윈도우즈 wsl2 로 테스트는 host os 가 windows 임으로 실제 linux 서버에서 테스트해야 동작합니다.)

파일 트리

.
└── tutorial-linux-monitoring-prometheus-grafana/
    ├── prometheus/
    │   └── prometheus.yml
    └── docker-compose.yml

prometheus/prometheus.yml

global:
  scrape_interval: 20s # 데이터 수집 주기

scrape_configs:
  - job_name: 'linux_server_info'
    # metrics_path: '/metrics' # 메트릭을 수집할 경로를 커스텀 할 수 있음
    static_configs:
      - targets: ['host.docker.internal:9100'] # 메트릭을 제공받을 서버의 주소

job_name: prometheus 에서 target check 에 명시될 대상 이름입니다.
metrics_path: static_configs.targets 에 명시한 속성의 path 입니다.(ex, 위의 경우 host.docker.internal:9100/metrics 로 설정됩니다.)
static_configs.targets: 메트릭 정보를 수집할 대상 URL 입니다.

docker-compose.yml

volumes:
  prometheus-data: # 시계열 데이터 저장을 위해 사용됩니다.
  grafana-data: # 대시보드 정보 기록을 위해 사용됩니다.

services:
  prometheus:
    image: prom/prometheus:latest
    container_name: prometheus
    extra_hosts:
      - "host.docker.internal:host-gateway" # 호스트 네트워크에 접근하기 위한 설정
    volumes:
      - prometheus-data:/prometheus
      - ./prometheus:/etc/prometheus # prometheus.yml 설정 파일
    command:
      - "--config.file=/etc/prometheus/prometheus.yml"
      - "--web.enable-lifecycle" # Prometheus 서버를 재시작하지 않고도 설정을 다시 읽을 수 있게 함
    ports:
      - "9090:9090"
    restart: unless-stopped

  grafana:
    image: grafana/grafana:latest
    container_name: grafana
    environment:
      - GF_SECURITY_ADMIN_USER=admin # grafana 사용자 계정
      - GF_SECURITY_ADMIN_PASSWORD=admin # grafana 사용자 비밀번호
    ports:
      - "3000:3000"
    restart: unless-stopped
    volumes:
      - grafana-data:/var/lib/grafana

  linux_server_info:
    image: quay.io/prometheus/node-exporter:latest
    container_name: linux_server_info
    command:
      - '--path.rootfs=/host'
    network_mode: host
    pid: host # 컨테이너에서 호스트의 프로세스를 볼 수 있게 함
    restart: unless-stopped
    depends_on:
      - prometheus
    volumes:
      - '/:/host:ro,rslave' # ro: 읽기전용, rslave: 마운트한 물리 경로의 것을 동기화만 하고 역동기화 하지 않음

services.prometheus.command."--web.enable-lifecycle": prometheus.yml 을 수정한 뒤 재시작 없이 설정 파일을 reload 할 수 있는 API 를 호출할 수 있게 해줍니다.
- prometheus 컨테이너에 접속하여 `localhost:9090/-/reload` URL 을 POST 형식으로 요청하면 reload 됩니다.

명령어

실행

docker comopse up -d

d 옵션은 백그라운에서 docker compose 가 실행될 수 있게 합니다.

종료

docker compose down

대시보드 UI 구축

[Monitoring] Prometheus 상태 확인과 Linux 서버의 Grafana dashboard 구축(feat. Grafana Dashboards Template)

발단 [Monitoring] Prometheus & Grafana 를 사용해 Linux 서버의 상태를 모니터링 해보자(feat. docker compose)발단 테스트 서버의 상태를 모니터링 할 수 있는 도구를 찾던 도중 예전부터 관심있던 Prometheus 와

atsky.tistory.com

해당 글에서 환경 구축에 따른 대시보드 UI 구축을 설명하고 있습니다.

[Spring Boot] Assert 가 동작하지 않는다?(feat. Kotlin)

sggnology — Fri, 22 Nov 2024 12:18:02 +0900

발단

assert 를 통한 로직 검증에서 조건이 틀렸음에도 검증되지 않고 Pass-Through 한 경우가 있어 정리합니다.

Assert 란 무엇인가?

var a = 1
var b = 2

assert(1 < a+b) // _Assertions object 를 통해 참조된 assert 를 사용
assert(a+b < 1) { "msg" }

영단어로써 의미는 `주장하다` 라는 뜻을 가지고 있습니다.
코드에서는 assert 로 묶은 조건이 옳음을 주장하다 정도로 볼 수 있을 거 같습니다.

_Assertions object

@file:kotlin.jvm.JvmMultifileClass
@file:kotlin.jvm.JvmName("PreconditionsKt")
package kotlin

@PublishedApi
internal object _Assertions {
    @JvmField
    @PublishedApi
    internal val ENABLED: Boolean = javaClass.desiredAssertionStatus()
}

/**
 * Throws an [AssertionError] if the [value] is false
 * and runtime assertions have been enabled on the JVM using the *-ea* JVM option.
 */
@kotlin.internal.InlineOnly
public inline fun assert(value: Boolean) {
    assert(value) { "Assertion failed" }
}

/**
 * Throws an [AssertionError] calculated by [lazyMessage] if the [value] is false
 * and runtime assertions have been enabled on the JVM using the *-ea* JVM option.
 */
@kotlin.internal.InlineOnly
public inline fun assert(value: Boolean, lazyMessage: () -> Any) {
    if (_Assertions.ENABLED) {
        if (!value) {
            val message = lazyMessage()
            throw AssertionError(message)
        }
    }
}

위에서 알 수 있듯 assert 는 함수로 오버로딩을 통해 두가지 사용방식을 제공합니다.

왜 assert 가 동작하지 않았던 걸까?

assert 는 _Assertions.ENABLED 라는 bool 값에 따라 동작 여부가 결정되고, JVM 은 기본적으로 실행할 때 assert 옵션을 사용한다 명시하지 않기에 동작하지 않았던 것 입니다.

어떻게 assert 옵션을 사용할 수 있을까?(JVM 실행 변수)

// -ea(ENABLE ASSERTION) 를 작성하면 ENABLED 옵션이 세팅됩니다.
java -ea -jar YourApplication.jar

// 특정 클래스에 적용
java -ea:com.example.MyClass -jar YourApplication.jar

// 특정 패키지에 적용(`...`를 붙여야 합니다.)
java -ea:com.example... -jar YourApplication.jar

옵션과 무관한 처리(Kotlin)

inline fun customAssert(value: Boolean, lazyMessage: () -> String) {
    if (!value) {
        throw AssertionError(lazyMessage())
    }
}

[Baekjoon] 2667번 단지번호붙이기(feat. Java)

sggnology — Fri, 15 Nov 2024 17:59:16 +0900

접근

단지에 대한 접근은 DFS 로 처리
단지구분은 숫자로 하여 DFS 가 접근한 단지에 대해 숫자로 기록
DFS 가 끝나면 단지 탐색이 끝나게 된 것임으로 단지 숫자 증가

해결

import java.io.*;
import java.util.*;

public class Main {

    static int N;
    static int[][] arr;
    static int[][] visited;
    static int beaconValue = 1; // 단지 번호

    public static void main(String[] args) throws IOException {
        BufferedReader br = new BufferedReader(new InputStreamReader(System.in));
        N = Integer.parseInt(br.readLine());

        arr = new int[N+1][N+1];
        visited = new int[N+1][N+1];

        for(int i=1;i<=N;i++){
            String[] arr1 = br.readLine().split("");

            for(int j=1;j<=N;j++){
                arr[i][j] = Integer.parseInt(arr1[j-1]);
            }
        }

        for(int y=1;y<=N;y++){
            for(int x=1;x<=N;x++){
                if(arr[y][x] == 1 && visited[y][x] == 0) {
                    dfs(y, x);
                    beaconValue += 1; // 단지 번호 증가
                }
            }
        }

        // 단지 수
        int danziCount = beaconValue - 1;

        int[] result = new int[danziCount];

        for(int y=1;y<=N;y++){
            for(int x=1;x<=N;x++){
                int danziValue = visited[y][x];

                if(0 < danziValue)
                    result[danziValue-1] += 1; // 단지별 집 수
            }
        }

        Arrays.sort(result);

        System.out.println(danziCount);

        for (int j : result) {
            System.out.println(j);
        }
    }

    public static void dfs(int Y, int X){
        if(arr[Y][X] == 0)
            return;

        visited[Y][X] = beaconValue;

        if(0 < X - 1 && arr[Y][X-1] == 1 && visited[Y][X-1] == 0){
            dfs(Y, X-1);
        }

        if(X + 1 <= N && arr[Y][X+1] == 1 && visited[Y][X+1] == 0){
            dfs(Y, X+1);
        }

        if(0 < Y - 1 && arr[Y-1][X] == 1 &&visited[Y-1][X] == 0){
            dfs(Y-1, X);
        }

        if(Y + 1 <= N && arr[Y+1][X] == 1 &&visited[Y+1][X] == 0){
            dfs(Y+1, X);
        }
    }
}

[Baekjoon] 2606번 바이러스(feat. Java)

sggnology — Fri, 15 Nov 2024 16:35:45 +0900

접근

각 컴퓨터를 접점으로 취급한채로 간선을 이중배열로 연결 관계 표시
방문여부와 접점간에 연결여부를 통해 접근가능한지 확인

해결

import java.io.*;
import java.util.*;

public class Main {

    static int[][] arr1;
    static int[][] visited1;
    static HashSet<Integer> set;

    public static void main(String[] args) throws IOException {
        BufferedReader br = new BufferedReader(new InputStreamReader(System.in));

        int N = Integer.parseInt(br.readLine());
        int M = Integer.parseInt(br.readLine());

        arr1 = new int[N+1][N+1];
        visited1 = new int[N+1][N+1];
        set = new HashSet<>();

        for(int i=0;i<M;i++){
            StringTokenizer st = new StringTokenizer(br.readLine());

            int X = Integer.parseInt(st.nextToken());
            int Y = Integer.parseInt(st.nextToken());

            arr1[X][Y] = arr1[Y][X] = 1;
        }

        dfs(1, N);

        System.out.println(set.size() - 1);
    }

    public static void dfs(int V, int N){
        int[] arr = arr1[V];

        set.add(V);

        for(int i=1;i<=N;i++){
            if(i == V)
                continue;

            if(arr[i] == 1 && visited1[V][i] == 0){
                visited1[V][i] = visited1[i][V] = 1;
                dfs(i, N);
            }
        }
    }
}

[Baekjoon] 1260번 DFS와 BFS(feat. Java)

sggnology — Thu, 14 Nov 2024 23:14:04 +0900

접근

DFS 는 재귀호출
BFS 는 Queue 가 핵심
접점이 이어진 간선을 어떻게 구성할것이냐가 핵심
- 이중 배열을 통해 접점간에 간선을 표시
- 인덱스 접근의 편의를 위해 0번째 자리는 패딩설정

해결

import java.io.*;
import java.util.*;

public class Main {

    public static String dfs = "";
    public static int[][] arr1;
    public static int[][] visited1;
    public static List<Integer> visitedElement1;

    public static String bfs = "";
    public static int[][] arr2;
    public static int[][] visited2;
    public static List<Integer> visitedElement2;

    public static void main(String args[]) throws IOException {
        BufferedReader br = new BufferedReader(new InputStreamReader(System.in));
        StringTokenizer st1 = new StringTokenizer(br.readLine());

        int N = Integer.parseInt(st1.nextToken());
        int M = Integer.parseInt(st1.nextToken());
        int V = Integer.parseInt(st1.nextToken());

        arr1 = new int[N+1][N+1];
        visited1 = new int[N+1][N+1];
        visitedElement1 = new ArrayList<>();

        arr2 = new int[N+1][N+1];
        visited2 = new int[N+1][N+1];
        visitedElement2 = new ArrayList<>();

        for(int i=0;i<M;i++){
            StringTokenizer st2 = new StringTokenizer(br.readLine());

            int A = Integer.parseInt(st2.nextToken());
            int B = Integer.parseInt(st2.nextToken());

            arr1[A][B] = 1;
            arr1[B][A] = 1;
            arr2[A][B] = 1;
            arr2[B][A] = 1;
        }

        dfs(N, V);
        bfs(V);

        System.out.println(dfs.trim());
        System.out.print(bfs.trim());
    }

    public static void dfs(int N, int V){

        dfs += V+" ";

        visitedElement1.add(V);

        int[] arr = arr1[V];
        int[] visited = visited1[V];

        for(int i=1;i<=N;i++){
            if(i == V)
                continue;

            if(arr[i] == 1 && visited[i] == 0 && !visitedElement1.contains(i)){
                visited1[V][i] = 1;
                visited1[i][V] = 1;
                dfs(N, i);
            }
        }
    }

    public static void bfs(int V) {
        Queue<Integer> queue = new LinkedList<>();
        queue.add(V);
        visitedElement2.add(V);

        while(!queue.isEmpty()){
            int v = queue.poll();
            bfs += v+" ";

            for(int i=1;i<arr2[v].length;i++){
                if(arr2[v][i] == 1 && visited2[v][i] == 0 && !visitedElement2.contains(i)){
                    queue.add(i);
                    visited2[v][i] = 1;
                    visited2[i][v] = 1;
                    visitedElement2.add(i);
                }
            }
        }
    }
}

[Baekjoon] 2178번 미로 탐색(feat. Java)

sggnology — Wed, 6 Nov 2024 23:25:49 +0900

접근

편의를 위해 N+1, M+1 크기 만큼의 이중배열 사용
방문 여부 확인을 위한 visited 이중 배열 사용
bfs 방식을 위한 count 이중 배열 사용(미로 이중배열과 같은)

해결

BFS

import java.io.*;
import java.util.*;

public class Main {

    static int N;
    static int M;
    static int[][] miro;
    static int[][] countMiro;
    static int[][] visited;
    static Integer result = null;
    static Queue<int[]> queue = new LinkedList<>();

    public static void main(String[] args) throws IOException {
        BufferedReader br = new BufferedReader(new InputStreamReader(System.in));

        StringTokenizer st = new StringTokenizer(br.readLine());

        N = Integer.parseInt(st.nextToken());
        M = Integer.parseInt(st.nextToken());

        miro = new int[N+1][M+1];
        countMiro = new int[N+1][M+1];
        visited = new int[N+1][M+1];
        visited[1][1] = 1;

        for(int i=1;i<=N;i++){

            String[] elements = br.readLine().split("");

            for(int j=1;j<=M;j++){

                int element = Integer.parseInt(elements[j-1]);

                miro[i][j] = element;
                countMiro[i][j] = element;
            }
        }

        queue.add(new int[]{1, 1});

        bfs();

        System.out.println(result);
    }

    public static void bfs(){

        while(queue.isEmpty() == false){
            int[] current = queue.poll();
            int currentX = current[0];
            int currentY = current[1];

            if(currentX==M && currentY==N){
                result = countMiro[currentY][currentX];
                return;
            }

            if(0 < currentX-1 && miro[currentY][currentX-1] == 1 && visited[currentY][currentX-1] == 0){
                visited[currentY][currentX-1] = 1;
                countMiro[currentY][currentX-1] = countMiro[currentY][currentX]+1;
                queue.add(new int[]{currentX-1, currentY});
            }

            if(0 < currentY-1 && miro[currentY-1][currentX] == 1 && visited[currentY-1][currentX] == 0){
                visited[currentY-1][currentX] = 1;
                countMiro[currentY-1][currentX] = countMiro[currentY][currentX]+1;
                queue.add(new int[]{currentX, currentY-1});
            }

            if(currentX+1 <= M && miro[currentY][currentX+1] == 1 && visited[currentY][currentX+1] == 0){
                visited[currentY][currentX+1] = 1;
                countMiro[currentY][currentX+1] = countMiro[currentY][currentX]+1;
                queue.add(new int[]{currentX+1, currentY});
            }

            if(currentY+1 <= N && miro[currentY+1][currentX] == 1 && visited[currentY+1][currentX] == 0){
                visited[currentY+1][currentX] = 1;
                countMiro[currentY+1][currentX] = countMiro[currentY][currentX]+1;
                queue.add(new int[]{currentX, currentY+1});
            }
        }
    }
}

DFS(시간 초과)

import java.io.*;
import java.util.*;

public class Main {

    static int N;
    static int M;
    static int[][] miro;
    static Integer result = null;

    public static void main(String[] args) throws IOException {
        BufferedReader br = new BufferedReader(new InputStreamReader(System.in));

        StringTokenizer st = new StringTokenizer(br.readLine());

        N = Integer.parseInt(st.nextToken());
        M = Integer.parseInt(st.nextToken());

        miro = new int[N+1][M+1];
        int[][] visited = new int[N+1][M+1];
        visited[1][1] = 1;

        for(int i=1;i<=N;i++){

            String[] elements = br.readLine().split("");

            for(int j=1;j<=M;j++){

                int element = Integer.parseInt(elements[j-1]);

                miro[i][j] = element;
            }
        }

        dfs(1, 1, visited, 1);

        System.out.println(result);
    }

    public static void dfs(int X, int Y, int[][] visited, int count){

        if(X==M && Y==N){
            if(result == null){
                result = count;
            }
            else{
                result = Math.min(result, count);
            }
            return;
        }

        if(0 < X-1 && miro[Y][X-1] == 1 && visited[Y][X-1] == 0){
            int[][] newVisited = copyVisited(visited);
            newVisited[Y][X-1]=1;
            recurse(X-1, Y, newVisited, count+1);
        }

        if(0 < Y-1 && miro[Y-1][X] == 1 && visited[Y-1][X] == 0){
            int[][] newVisited = copyVisited(visited);
            newVisited[Y-1][X]=1;
            recurse(X, Y-1, newVisited, count+1);
        }

        if(X+1 <= M && miro[Y][X+1] == 1 && visited[Y][X+1] == 0){
            int[][] newVisited = copyVisited(visited);
            newVisited[Y][X+1]=1;
            recurse(X+1, Y, newVisited, count+1);
        }

        if(Y+1 <= N && miro[Y+1][X] == 1 && visited[Y+1][X] == 0){
            int[][] newVisited = copyVisited(visited);
            newVisited[Y+1][X]=1;
            recurse(X, Y+1, newVisited, count+1);
        }
    }

	// 강복사를 통한 visited 물리적 분리, 편의 복사 메서드
    public static int[][] copyVisited(int[][] visited){
        int[][] copied = new int[N+1][M+1];

        for(int i=1;i<=N;i++){
            for(int j=1;j<=M;j++){
                copied[i][j] = visited[i][j];
            }
        }

        return copied;
    }

	// 현재 상황 조회를 위한 로깅 함수
    public static void printMiro(){
        String result = "";

        System.out.println();
        for(int i=0;i<=N;i++){
            for(int j=0;j<=M;j++){
                result += miro[i][j]+" ";
            }
            result += "\n";
        }

        System.out.println(result);
    }

	// 현재 상황 조회를 위한 로깅 함수
    public static void printVisited(int[][] visited){
        String result = "";

        System.out.println();
        for(int i=0;i<=N;i++){
            for(int j=0;j<=M;j++){
                result += visited[i][j]+" ";
            }
            result += "\n";
        }

        System.out.println(result);
    }
}

[Kotlin] 함수에 인자로 함수를 사용할 수 있다?(feat. 고차함수, 함수형 인터페이스)

sggnology — Fri, 28 Jun 2024 11:42:35 +0900

고차 함수

    fun m1(action: () -> Unit) {
        action()
    }

고차 함수는 함수를 인자로 받거나 함수를 반환하는 함수 입니다. Kotlin 에서는 함수 매개변수를 사용할 수 있습니다.

람다 표현식

val sum: (Int, Int) -> Int = { a, b -> a + b }
println(sum(3, 4))  // 출력: 7

람다는 익명 함수로, 코드 블럭을 변수처럼 사용하거나 함수의 인자로 전달할 수 있게 해줍니다. 람다 표현식은 `{..}` 로 정의됩니다.

`고차 함수`와 `람다 표현식`

// 고차 함수
fun m1(action: (Int) -> String) {
    println(action(1))
}

// 람다 표현식 호출
m1 {
    "it is $it"
}

위와 코드 예제와 같이 Kotlin 에서 고차 함수는 람다 표현식으로 표현될 수 있습니다.

함수형 인터페이스 & SAM(Single Abstract Method) 변환

// 함수형 인터페이스
interface IDoingThing {
    fun doThing()
}

// 함수형 인터페이스를 인자로 가지는 함수
fun m2(arg1: IDoingThing) {
	arg1.doThing()
}

// 람다 표현식 변환 호출
// IDoingThing 인터페이스의 doThing 을 람다 표현식으로 재정의 한거처럼 표현됩니다.
m2 {
    println("Doing something")
}

`함수형 인터페이스`는 단일 메서드를 가지는 인터페이스를 일컫습니다.
Kotlin 에서는 위와 같은 `함수형 인터페이스`에 대해 람다 표현식으로 대체할 수 있습니다.

[Spring] Spring Security + MockMvc 로 테스트시 주의할 점(feat. kotlin)

sggnology — Fri, 28 Jun 2024 10:49:59 +0900

발단

Spring Security 와 MockMvc 를 Kotlin 환경에서 검증을 하던 도중 설정(config)이 옳음에도 테스트의 결과가 일관된 반응을 하는 현상을 발견하여 그 이유를 알아보고 왜 그러하였는지 과정을 작성합니다.

Kotlin 고차함수 & 함수형 인터페이스

[Kotlin] 함수에 인자로 함수를 사용할 수 있다?(feat. 고차함수,

고차 함수 fun m1(action: () -> Unit) { action() }고차 함수는 함수를 인자로 받거나 함수를 반환하는 함수 입니다. Kotlin 에서는 함수 매개변수를 사용할 수 있습니다. 람다 표현식val sum: (Int, Int) -> Int

atsky.tistory.com

Kotlin 의 고차함수에 대하여 위 글을 통해 개념을 간단히 보시면 더 이해가 쉽습니다.
SAM(Single Abstract Method) 변환에 대해서도 다루고 있습니다.

MockMvc 호출을 Kotlin 으로 표현하는 2가지 방식

import org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get

..

@Autowired
lateinit var mockMvc: MockMvc

// 정석적인 호출
mockMvc.perform(
	get("/api/test")
)..

// SAM 변환을 사용한 호출
mockMvc.perform {
	get("/api/test")
    	.buildRequest(it)
}..

정석적인 호출: perform 함수의 매개변수인 `RequestBuilder` 를 반환 타입으로 가지는 함수(get, put..)를 호출하여 처리할 수 있습니다.
SAM 변환 호출: perform 의 반환타입인 `MockHttpServletRequest` 를 반환하게끔 처리할 수 있습니다.

2가지 방식을 호출할 가능성

제가 사용하고 있는 Intellij 의 경우 SAM 변환이 가능한 호출의 경우 SAM 변환 방식을 선 추천해주고 있습니다.
따라서, 2가지 방식 어느것이든 같은 결과를 가질 것이라 예측하고 의심없이 사용하게 될 수 있다고 생각됩니다.

Spring Security 와 사용시 문제 발생

..
@Test
@WithMockUser(roles = ["MANAGER"]) // spring security test 를 위한 annotation 으로 인증된 가상 사용자를 제공합니다.
fun test1() {
	..
    // `/api/test` 엔드포인트는 `MANAGER` 권한이 있어야 접근이 가능합니다.
    mockMvc
    	// 정석적인 호출
    	.perform(get("/api/test"))
        // SAM 변환 호출
        .perform {
        	get("/api/test").buildRequest(it)
        }
    	.andExpect {
        	// 인증된 가상 사용자 권한을 추가하였기에 검증을 통과하여야 합니다.
        	Assertions.assertEquals(it.response.status, 200)
        }
}

정석적인 호출 사용시 @WithMockUser 로 제공한 가상 사용자 권한이 허용되어 검증을 통과합니다.
그러나, SAM 변환 사용시 사용자 권한 검증에 통과하지 못하게 됩니다.

문제 발생 이유

위에서 언급하였던 mockMvc.perform(..) 함수의 파라미터 타입은 `RequestBuilder` 입니다.
그런데 SAM 변환을 적용하면서 저는 RequestBuilder 타입을 반환하는 람다를 인자로 전달하였습니다.
이는 ..perform(..) 내부 동작에 문제가 발생하게 만듭니다.

defaultRequestBuilder 와 Merge 가 되지 않아 TestSecurityContext 미적용

// MockMvc.perform 메서드 일부
public ResultActions perform(RequestBuilder requestBuilder) throws Exception {
    // requestBuilder 는 Mergeable 인스턴스의 일부인지 묻고 있습니다.
    if (this.defaultRequestBuilder != null && requestBuilder instanceof Mergeable) {
        requestBuilder = (RequestBuilder)((Mergeable)requestBuilder).merge(this.defaultRequestBuilder);
    }
    ...
}

// (Mergeable)requestBuilder.merge 메서드 일부
public Object merge(@Nullable Object parent) {
    ...
    this.postProcessors.addAll(0, parentBuilder.postProcessors);
    return this;
    ...
}

// TestSecurityContextHolderPostProcessor.postProcessRequeset 메서드 일부
private static final class TestSecurityContextHolderPostProcessor extends SecurityContextRequestPostProcessorSupport implements RequestPostProcessor {
    ...
    public MockHttpServletRequest postProcessRequest(MockHttpServletRequest request) {
        ...
        // TestSecurityContext 를 SecurityContext 로 대체
        SecurityContext context = TestSecurityContextHolder.getContext();
        if (!this.EMPTY.equals(context)) {
            this.save(context, request);
        }

        return request;
        ...
    }
}

MockMvc.perform 코드블럭의 첫 if 문에 따라 requestBuilder 가 Mergeable 인스턴스에 포함된다면 merge 함수를 통해 defaultRequestBuilder 와 merge 해주고 있습니다.
저는 requestBuilder 를 SAM 변환을 통해 람다로 제공하였기에 람다는 Mergeable 인스턴스가 아니라 merge 를 호출할 수 없었습니다.
merge 메서드 내부 동작을 살펴보면 parentBuilder(defaultRequestBuilder)로 부터 postProcessors 를 merge 하고 있는 것을 알 수 있습니다.

parentBuilder.postProcessors 내부에는 SecurityMockMvcRequestPostProcessors 클래스가 포함되어 있습니다.
이 클래스의 postProcessRequest 메서드는 TestSecurityContext 를 현재 호출의 context 로 대체하여 줍니다.
따라서, @WithMockUser 로 제공한 정보를 context 에 반영하게 되어 인증/권한 정보를 가진 채로 호출할 수 있게 됩니다.

결론

Builder 패턴혹은 호출전 다양한 설정이 적용되어야 하는 클래스의 경우 설정 적용을 위해 내부적으로 다양한 조건문을 사용할 수 있습니다.
이는 인터페이스 혹은 고차함수 등으로 복잡한 인수가 포함될 수 있습니다.
따라서, 정석적이 방식의 호출을 사용하는 것이 오류 확률을 줄여줄 것이라 생각합니다.
위 경우처럼 본인이 구현한 동작이 아니고서야 SAM 변환은 줄이는 것이 좋겠다는 생각이 듭니다.

[Visual Studio] WCF 수정시 수정/삭제 없이 업데이트 하는 방법(feat. visual studio version)

sggnology — Mon, 17 Jun 2024 21:22:09 +0900

발단

WCF 라이브러리의 수정 이후 참조 추가한 프로젝트에 대해 갱신하려 할 때 삭제/추가 없이 갱신하다가 업데이트 하는 방식이 있을 듯 하여 방법을 정리합니다.

환경

IDE: Visual Studio 2019

WCF 업데이트 문서

Add, update, or remove WCF data service reference - Visual Studio (Windows)

Explore how to add, update, or remove a Windows Communication Foundation (WCF) data service reference for .NET Framework applications in Visual Studio.

learn.microsoft.com

ms 에서 제공하는 문서에 따르면 update 기능을 제공한다고 하지만 제가 사용중인 2019 버전에서는 제공하지 않는 것으로 보입니다.
문서의 마지막 작성일자를 보면 비교적 최근이지만 부분적인 수정이 이루어졌을 수 있기에 개발자 커뮤니티를 찾아보았습니다.

MS 개발자 커뮤니티 Visual Studio

<p>Update service reference menu WCF is not there anymo...

<p>[regression] [worked-in:16.10] Since a couple of version, it seems the menu to update a service reference is gone:</p> <p><img src=https://aka.ms/d...

developercommunity.visualstudio.com

질문자는 update 기능이 사라져서 곤란하다는 내용입니다.
이에 답변은 다음과 같이 얘기하고 있습니다.
- 16.11 버전 부터 `연결된 서비스` 에 접근하여 서비스 옆에 위치한 버튼으로 `수정`을 선택 마법사를 통해 서비스를 업데이트 하면 됩니다.

해결

    [ServiceContract]
    public interface IService1
    {
        [OperationContract]
        int TestGet(int value);
    }
    
    public class Service1 : IService1
    {
        public int TestGet(int value)
        {
            return 0;
        }
    }

테스트를 위해 WCF 라이브러리에 간단한 메서드(TestGet)를 추가하였습니다.

연결된 서비스 접근

수정(Edit)을 통한 마법사 호출

마법사를 통한 업데이트

마법사에서 이동을 통해 참조하였던 WCF 에 접근하여 현 상태를 볼 수 있습니다.
이상하시게 느낀다면 맞습니다. TestGet 메서드를 추가하였지만 여기서는 노출되지 않고 있습니다. 이를 최신화 하기 위해서는 우선 `중지` 버튼을 통해 현재 상태 추출을 그만하고 `검색`을 한뒤 최신화된 Service 를 가져오면 됩니다.
이 때, Service 정보 즉 WCF 의 변화가 적용될 수 있게끔 빌드를 꼭 행해주세요.

`중지` 버튼과 `검색` 버튼을 순차적으로 행한뒤 Service 상태

이로써 수정/삭제 없이 WCF 를 최신화 할 수 있습니다.