"일꾼이 일을 잘하려면 먼저 도구를 갈고 닦아야 한다." - 공자, 『논어』.
첫 장 > 프로그램 작성 > Iris용 AccessLog 미들웨어

Iris용 AccessLog 미들웨어

2024-11-03에 게시됨
검색:581

AccessLog Middleware for Iris

Iris 웹 프레임워크용 accesslog 미들웨어는 들어오는 HTTP 요청에 대한 자세한 로깅을 제공합니다. 이 미들웨어는 고도로 구성 가능하며 사용자 정의 필드를 포함하여 요청 및 응답의 다양한 측면을 기록할 수 있습니다.

특징

  • 요청 및 응답 세부정보를 기록합니다.
  • 다양한 출력 형식(JSON, CSV, 맞춤 템플릿)을 지원합니다.
  • 여러 대상(파일, stdout 등)에 로그인할 수 있습니다.
  • 비동기 로깅 지원.
  • 사용자 정의 가능한 로그 필드.
  • 미들웨어를 조건부로 적용할 수 있습니다.

설치

accesslog 미들웨어를 사용하려면 Iris 애플리케이션에서 이를 가져와야 합니다.

import (
    "github.com/kataras/iris/v12"
    "github.com/kataras/iris/v12/middleware/accesslog"
)

기본 사용법

다음은 Iris 애플리케이션에서 accesslog 미들웨어를 사용하는 방법에 대한 기본 예입니다.

package main

import (
    "github.com/kataras/iris/v12"
    "github.com/kataras/iris/v12/middleware/accesslog"
)

func makeAccessLog() *accesslog.AccessLog {
    ac := accesslog.File("./access.log")

    ac.Delim = '|'
    ac.TimeFormat = "2006-01-02 15:04:05"
    ac.Async = false
    ac.IP = true
    ac.BytesReceivedBody = true
    ac.BytesSentBody = true
    ac.BytesReceived = false
    ac.BytesSent = false
    ac.RequestBody = true
    ac.ResponseBody = false
    ac.KeepMultiLineError = true
    ac.PanicLog = accesslog.LogHandler

    ac.SetFormatter(&accesslog.JSON{
        Indent:    "  ",
        HumanTime: true,
    })

    return ac
}

func main() {
    ac := makeAccessLog()
    defer ac.Close()

    app := iris.New()
    app.UseRouter(ac.Handler)

    app.Get("/", func(ctx iris.Context) {
        ctx.WriteString("OK")
    })

    app.Listen(":8080")
}

구성 옵션

출력 대상

파일 또는 새 기능을 사용하여 로그의 출력 대상을 설정할 수 있습니다.

ac := accesslog.File("./access.log")
// or
ac := accesslog.New(os.Stdout)

로그 형식

기본 로그 형식은 다음과 같습니다.

Time|Latency|Code|Method|Path|IP|Path Params Query Fields|Bytes Received|Bytes Sent|Request|Response|

다양한 포맷터를 사용하여 로그 형식을 맞춤설정할 수 있습니다.

JSON 포맷터

ac.SetFormatter(&accesslog.JSON{
    Indent:    "  ",
    HumanTime: true,
})

CSV 포맷터

ac.SetFormatter(&accesslog.CSV{})

사용자 정의 템플릿 포맷터

ac.SetFormatter(&accesslog.Template{Text: "{{.Code}}"})

사용자 정의 필드

로그 항목에 사용자 정의 필드를 추가할 수 있습니다.

ac.AddFields(func(ctx iris.Context, f *accesslog.Fields) {
    for k, v := range ctx.Request().Header {
        value := strings.Join(v, ", ")
        f.Set("request.header." k, value)
    }
})

비동기 로깅

비동기 로깅을 활성화하여 성능 향상:

ac.Async = true

조건부 로깅

특정 경로나 조건에 대한 로깅을 건너뛸 수 있습니다.

app.UseRouter(accesslog.SkipHandler)

고급 사용법

여러 대상에 로깅

io.MultiWriter:
를 사용하여 여러 대상에 로그인할 수 있습니다.

ac.SetOutput(io.MultiWriter(os.Stdout, accesslog.File("./access.log")))

맞춤 시계

테스트에 유용한 로그 타임스탬프에 대한 사용자 정의 시계를 설정할 수 있습니다.

ac.Clock = accesslog.TClock(time.Now())

미들웨어 통합

accesslog 미들웨어를 다른 미들웨어와 통합합니다.

app.UseRouter(ac.Handler)
app.UseRouter(otherMiddleware)

JSON 파일에 요청 기록

ac := accesslog.File("access_log.json")
ac.SetFormatter(&accesslog.JSON{
    Indent:    "  ",
    HumanTime: true,
})
app.UseRouter(ac.Handler)

로그 회전 사용

자세한 내용은 로그 회전 예시를 참고하세요.

사용자 정의 필드 및 템플릿

자세한 내용은 맞춤 필드 및 템플릿 예시를 참조하세요.

클라이언트에 대한 로그 수신 및 렌더링

자세한 내용은 로그 브로커 예시를 참조하세요.

결론

Iris용 accesslog 미들웨어는 HTTP 요청 및 응답을 기록하는 강력한 도구입니다. 유연한 구성 옵션과 사용자 정의 필드 및 형식 지원을 통해 모든 애플리케이션의 요구 사항에 맞게 맞춤화할 수 있습니다.

더 많은 예시와 자세한 사용법은 Iris 공식 문서를 참고하세요.

릴리스 선언문 이 글은 https://dev.to/kataras/accesslog-middleware-for-iris-4lhm?1에서 복제됩니다.1 침해 내용이 있는 경우, [email protected]으로 연락하여 삭제하시기 바랍니다.
최신 튜토리얼 더>

부인 성명: 제공된 모든 리소스는 부분적으로 인터넷에서 가져온 것입니다. 귀하의 저작권이나 기타 권리 및 이익이 침해된 경우 자세한 이유를 설명하고 저작권 또는 권리 및 이익에 대한 증거를 제공한 후 이메일([email protected])로 보내주십시오. 최대한 빨리 처리해 드리겠습니다.

Copyright© 2022 湘ICP备2022001581号-3