Logging ko KR

로그

ASF는 런타임 중 사용될 사용자 지정 커스텀 로깅 모듈을 설정할 수 있도록 해줍니다. 애플리케이션 디렉토리에 NLog.config라는 특수 파일을 배치하면 이 기능을 사용하실 수 있습니다. NLog의 전체 문서는 **NLog 위키**에서 확인하실 수 있으며, 이에 더해 여기서도 유용한 예시들을 함께 제공해드립니다.

---

기본 로그

기본적으로 ASF는 ColoredConsole(표준 출력)과 File에 로그를 기록합니다. File 로깅에는 프로그램 디렉토리의 log.txt 파일과, 보관 목적의 logs 디렉토리가 포함됩니다.

커스텀 NLog 설정을 사용하면 기본 ASF 설정이 자동으로 비활성화됩니다. 즉, 사용자의 설정이 기본 ASF 로깅을 완전히 덮어쓰므로, 예를 들어 저희의 ColoredConsole 타겟을 계속 유지하고 싶으시다면 직접 정의하셔야 합니다. 이를 통해 추가 로깅 타겟을 더할 수 있을 뿐만 아니라, 기본 타겟을 비활성화하거나 수정할 수도 있습니다.

기본 ASF 로깅을 아무런 수정 없이 그대로 사용하고 싶으시다면, 별도로 아무것도 하실 필요가 없습니다 - 커스텀 NLog.config에 정의하실 필요도 없습니다. 참고로, 하드코딩된 기본 ASF 로깅과 동등한 설정은 다음과 같습니다:

<?xml version="1.0" encoding="utf-8" ?>
<nlog xmlns="https://nlog-project.org/schemas/NLog.xsd" xsi:schemaLocation="NLog NLog.xsd" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance">
  <targets>
    <target xsi:type="ColoredConsole" name="ColoredConsole" layout="${date:format=yyyy-MM-dd HH\:mm\:ss}|${processname}-${processid}|${level:uppercase=true}|${logger}|${message}${onexception:inner= ${exception:format=toString,Data}}" />
    <target xsi:type="File" name="File" archiveFileName="${currentdir:cached=true}/logs/log.txt" archiveOldFileOnStartup="true" archiveSuffixFormat=".{1:yyyyMMdd-HHmmss}" fileName="${currentdir:cached=true}/log.txt" layout="${date:format=yyyy-MM-dd HH\:mm\:ss}|${processname}-${processid}|${level:uppercase=true}|${logger}|${message}${onexception:inner= ${exception:format=toString,Data}}" maxArchiveFiles="10" />

    <!-- Below becomes active when ASF's IPC interface is started -->
    <target type="History" name="History" layout="${date:format=yyyy-MM-dd HH\:mm\:ss}|${processname}-${processid}|${level:uppercase=true}|${logger}|${message}${onexception:inner= ${exception:format=toString,Data}}" maxCount="20" />
  </targets>

  <rules>
    <!-- The following entries specify ASP.NET (IPC) logging, we declare those so our last Debug catch-all doesn't include ASP.NET logs by default -->
    <logger name="Microsoft.Hosting.Lifetime" finalMinLevel="Info" writeTo="ColoredConsole" />
    <logger name="Microsoft.*" finalMinLevel="Warn" writeTo="ColoredConsole" />
    <logger name="System.*" finalMinLevel="Warn" writeTo="ColoredConsole" />

    <logger name="*" minlevel="Debug" writeTo="ColoredConsole" />

    <!-- The following entries specify ASP.NET (IPC) logging, we declare those so our last Debug catch-all doesn't include ASP.NET logs by default -->
    <logger name="Microsoft.Hosting.Lifetime" finalMinLevel="Info" writeTo="File" />
    <logger name="Microsoft.*" finalMinLevel="Warn" writeTo="File" />
    <logger name="System.*" finalMinLevel="Warn" writeTo="File" />

    <logger name="*" minlevel="Debug" writeTo="File" />

    <!-- Below becomes active when ASF's IPC interface is enabled -->
    <!-- The following entries specify ASP.NET (IPC) logging, we declare those so our last Debug catch-all doesn't include ASP.NET logs by default -->
    <logger name="Microsoft.Hosting.Lifetime" finalMinLevel="Info" writeTo="History" />
    <logger name="Microsoft.*" finalMinLevel="Warn" writeTo="History" />
    <logger name="System.*" finalMinLevel="Warn" writeTo="History" />

    <logger name="*" minlevel="Debug" writeTo="History" />
  </rules>
</nlog>

---

ASF integration

ASF는 NLog와의 통합을 강화하는 몇 가지 유용한 코드 기법들을 포함하고 있어, 특정 메시지를 더욱 쉽게 포착할 수 있게 해줍니다.

NLog 전용 ${logger} 변수는 항상 메시지의 출처를 구분해줍니다 - 이는 사용자의 봇 중 하나의 BotName이거나, 메시지가 ASF 프로세스에서 직접 발생한 경우라면 ASF가 됩니다. 이 방식을 통해, 로거의 이름을 기준으로 전체 메시지 대신 특정 봇(들)이나 ASF 프로세스(단독)와 관련된 메시지만 손쉽게 포착하실 수 있습니다.

ASF는 NLog가 제공하는 로깅 레벨을 기준으로 메시지에 적절히 태그를 지정하려 시도하며, 이를 통해 전체 메시지 대신 특정 로그 레벨의 메시지만 포착하실 수 있습니다. 물론, 특정 메시지의 로깅 레벨은 사용자가 임의로 커스터마이징할 수 없습니다. 이는 해당 메시지가 얼마나 심각한지에 대한 ASF의 하드코딩된 판단이기 때문입니다. 다만 원하시는 대로 ASF의 로그 출력량을 더 적게 또는 더 많게 조정하는 것은 확실히 가능합니다.

ASF는 사용자/채팅 메시지와 같은 추가 정보를 Trace 로깅 레벨에서 기록합니다. 기본 ASF 로깅은 Debug 레벨 이상만 기록하며, 이는 대다수의 사용자에게 불필요한 추가 정보를 숨기고, 더 중요할 수 있는 메시지가 포함된 출력 결과가 지저분해지는 것을 방지하기 위함입니다. 다만 Trace 로깅 레벨을 다시 활성화하면 이 정보를 활용하실 수 있습니다. 특히 관심 있는 특정 이벤트와 함께, 원하는 봇 하나만 로깅하도록 조합하는 경우 더욱 유용합니다.

일반적으로 ASF는 grep과 같은 제3자 도구로 사용자가 직접 수동으로 필터링하도록 강제하는 대신, 원하는 메시지만 로그로 남길 수 있도록 최대한 쉽고 편리하게 만들려고 노력합니다. 아래에 설명된 대로 NLog를 올바르게 설정하기만 하면, 전체 데이터베이스와 같은 커스텀 타겟을 포함하여 매우 복잡한 로깅 규칙까지도 지정하실 수 있습니다.

버전 관리와 관련하여 - ASF는 ASF 릴리스 시점 기준으로 **NuGet**에서 구할 수 있는 가장 최신 버전의 NLog를 항상 함께 배포하려고 노력합니다. NLog 위키에서 찾을 수 있는 어떤 기능이든 ASF에서 사용하는 데 문제가 없어야 합니다 - 다만 최신 버전의 ASF를 사용하고 계신지만 확인해 주세요.

ASF 통합의 일환으로, ASF는 아래에서 설명할 추가적인 ASF 전용 NLog 로깅 타겟도 지원합니다.

---

예제

아래의 예시들은 원하는 대로 로깅을 커스터마이징하는 방법을 보여드립니다.

시작으로 ColoredConsole 타겟만 사용해보겠습니다. 저희의 초기 NLog.config는 다음과 같은 모습입니다:

<?xml version="1.0" encoding="utf-8" ?>
<nlog xmlns="https://nlog-project.org/schemas/NLog.xsd" xsi:schemaLocation="NLog NLog.xsd" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance">
  <targets>
    <target xsi:type="ColoredConsole" name="ColoredConsole" />
  </targets>

  <rules>
    <logger name="*" minlevel="Debug" writeTo="ColoredConsole" />
  </rules>
</nlog>

위 설정에 대한 설명은 매우 간단합니다 - 저희는 ColoredConsole이라는 하나의 로깅 타겟을 정의한 다음, Debug 레벨 이상의 모든 로거(*)를 앞서 정의한 ColoredConsole 타겟으로 리다이렉트합니다.

만약 지금 위의 NLog.config로 ASF를 시작하면, ColoredConsole 타겟만 활성화되며, 하드코딩된 ASF NLog 설정과 관계없이 ASF는 File에 기록하지 않게 됩니다.

layout과 같은 여러 속성을 별도로 정의하지 않았기 때문에, 기본 내장값인 ${longdate}|${level:uppercase=true}|${logger}|${message}로 초기화되었습니다. 이를 커스터마이징할 수도 있습니다. 예를 들어 메시지만 기록하도록 다음과 같이 설정할 수 있습니다:

<?xml version="1.0" encoding="utf-8" ?>
<nlog xmlns="https://nlog-project.org/schemas/NLog.xsd" xsi:schemaLocation="NLog NLog.xsd" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance">
  <targets>
    <target xsi:type="ColoredConsole" name="ColoredConsole" layout="${message}" />
  </targets>

  <rules>
    <logger name="*" minlevel="Debug" writeTo="ColoredConsole" />
  </rules>
</nlog>

이제 ASF를 실행하시면, 날짜, 레벨, 로거 이름이 사라지고 Function() Message 형식의 ASF 메시지만 남는 것을 확인하실 수 있습니다.

또한 설정을 수정하여 두 개 이상의 타겟에 로그를 기록할 수도 있습니다. ColoredConsole과 **File**에 동시에 로그를 기록해봅시다.

<?xml version="1.0" encoding="utf-8" ?>
<nlog xmlns="https://nlog-project.org/schemas/NLog.xsd" xsi:schemaLocation="NLog NLog.xsd" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance">
  <targets>
    <target xsi:type="ColoredConsole" name="ColoredConsole" />
    <target xsi:type="File" name="File" fileName="${currentdir:cached=true}/NLog.txt" deleteOldFileOnStartup="true" />
  </targets>

  <rules>
    <logger name="*" minlevel="Debug" writeTo="ColoredConsole" />
    <logger name="*" minlevel="Debug" writeTo="File" />
  </rules>
</nlog>

완료되었습니다. 이제 모든 것이 ColoredConsole과 File에 로그로 기록됩니다. 사용자 지정 fileName이나 추가 옵션도 설정할 수 있다는 것을 눈치채셨나요?

마지막으로, ASF는 사용자가 현재 상황을 더 쉽게 이해할 수 있도록 다양한 로그 레벨을 사용합니다. 이 정보를 활용하여 로깅의 심각도(severity)를 수정할 수 있습니다. 모든 것을(Trace) File에 기록하되, ColoredConsole에는 Warning 이상의 **로그 레벨**만 기록하고 싶다고 가정해봅시다. rules를 수정하여 이를 달성할 수 있습니다:

<?xml version="1.0" encoding="utf-8" ?>
<nlog xmlns="https://nlog-project.org/schemas/NLog.xsd" xsi:schemaLocation="NLog NLog.xsd" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance">
  <targets>
    <target xsi:type="ColoredConsole" name="ColoredConsole" />
    <target xsi:type="File" name="File" fileName="${currentdir:cached=true}/NLog.txt" deleteOldFileOnStartup="true" />
  </targets>

  <rules>
    <logger name="*" minlevel="Warn" writeTo="ColoredConsole" />
    <logger name="*" minlevel="Trace" writeTo="File" />
  </rules>
</nlog>

이렇게 하면, 이제 저희의 ColoredConsole은 경고(warning) 이상만 표시하고, File에는 여전히 모든 것을 기록합니다. 예를 들어 Info 이하만 기록하는 등, 원하는 대로 더 세밀하게 조정하실 수도 있습니다.

마지막으로, 조금 더 고급 기능을 사용해서 LogBot이라는 이름의 봇에서 발생한 메시지만 파일에 기록해봅시다.

<?xml version="1.0" encoding="utf-8" ?>
<nlog xmlns="https://nlog-project.org/schemas/NLog.xsd" xsi:schemaLocation="NLog NLog.xsd" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance">
  <targets>
    <target xsi:type="ColoredConsole" name="ColoredConsole" />
    <target xsi:type="File" name="LogBotFile" fileName="${currentdir:cached=true}/LogBot.txt" deleteOldFileOnStartup="true" />
  </targets>

  <rules>
    <logger name="*" minlevel="Debug" writeTo="ColoredConsole" />
    <logger name="LogBot" minlevel="Trace" writeTo="LogBotFile" />
  </rules>
</nlog>

위에서 사용한 ASF 통합 기능을 활용하여 ${logger} 속성을 기준으로 메시지의 출처를 손쉽게 구분한 방식을 확인하실 수 있습니다.

---

고급 사용법

위의 예시들은 ASF와 함께 사용할 수 있는 나만의 로깅 규칙을 정의하는 것이 얼마나 쉬운지 보여드리기 위해 비교적 간단하게 만들어졌습니다. NLog는 다양한 용도로 활용하실 수 있습니다. 예를 들어 Database에 로그를 보관하는 것과 같은 복잡한 타겟, (오래된 File 로그를 제거하는 것과 같은) 로그 순환(rotation), 커스텀 Layout 사용, 자신만의 <when> 로깅 필터 선언 등 다양한 활용이 가능합니다. 원하시는 대로 ASF 로깅 모듈을 세밀하게 조정할 수 있도록, 이용 가능한 모든 옵션을 알아보기 위해 전체 **NLog 문서**를 꼭 읽어보시길 권장드립니다. 이는 정말 강력한 도구이며, ASF 로깅을 커스터마이징하는 것이 이보다 더 쉬운 적은 없었습니다.

---

한계

ASF는 사용자 입력을 기다릴 때, ColoredConsole이나 Console 타겟이 포함된 모든 규칙을 일시적으로 비활성화합니다. 따라서 ASF가 사용자 입력을 기다리는 동안에도 다른 타겟에 대한 로깅을 계속 유지하고 싶으시다면, 위 예시에서 보여드린 것처럼 해당 타겟들을 자신만의 별도 규칙으로 정의하셔야 합니다. 동일한 규칙의 writeTo에 여러 타겟을 함께 넣는 것(의도적으로 그렇게 하시려는 경우가 아니라면)은 피하시기 바랍니다. 콘솔 타겟을 일시적으로 비활성화하는 것은 사용자 입력을 기다리는 동안 콘솔 화면을 깔끔하게 유지하기 위한 조치입니다.

---

채팅 로그

ASF는 채팅 로깅에 대한 확장 지원을 포함하고 있어, 수신/발신된 모든 메시지를 Trace 로깅 레벨에서 기록할 뿐만 아니라, 이와 관련된 추가 정보를 **이벤트 속성(event properties)**으로도 노출합니다. 이는 어차피 채팅 메시지를 명령어로 처리해야 하기 때문에, 이러한 이벤트를 로그로 기록하는 데 별도의 비용이 들지 않기 때문입니다. 이를 통해 사용자는 추가적인 로직을 구현할 수 있습니다(예: ASF를 본인만의 개인 Steam 채팅 아카이브로 만드는 것).

이벤트 속성

이름	설명
Echo	bool 타입. 메시지가 저희 측에서 수신자에게 발신되고 있는 경우에는 true로, 그렇지 않은 경우에는 false로 설정됩니다.
Message	string 타입. 이는 실제로 발신/수신된 메시지입니다.
ChatGroupID	ulong 타입. 이는 발신/수신 메시지가 속한 그룹 채팅의 ID입니다. 이 메시지 전송에 그룹 채팅이 사용되지 않은 경우에는 0이 됩니다.
ChatID	ulong 타입. 이는 발신/수신 메시지가 속한 ChatGroupID 채널의 ID입니다. 이 메시지 전송에 그룹 채팅이 사용되지 않은 경우에는 0이 됩니다.
SteamID	ulong 타입. 이는 발신/수신 메시지에 관련된 Steam 사용자의 ID입니다. 특정 사용자가 메시지 전송에 관여하지 않은 경우(예: 저희가 그룹 채팅으로 메시지를 보내는 경우)에는 0이 될 수 있습니다.

예시

이 예시는 위에서 다룬 저희의 ColoredConsole 기본 예시를 기반으로 합니다. 이해하시기 전에, 먼저 NLog 로깅의 기본 개념을 익히기 위해 **위 내용**을 먼저 확인해보시기를 강력히 권장드립니다.

<?xml version="1.0" encoding="utf-8" ?>
<nlog xmlns="https://nlog-project.org/schemas/NLog.xsd" xsi:schemaLocation="NLog NLog.xsd" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance">
  <targets>
    <target xsi:type="ColoredConsole" name="ColoredConsole" />
    <target xsi:type="File" name="ChatLogFile" fileName="${currentdir:cached=true}/logs/chat/${event-properties:item=ChatGroupID}-${event-properties:item=ChatID}${when:when='${event-properties:item=ChatGroupID}' == 0:inner=-${event-properties:item=SteamID}}.txt" layout="${date:format=yyyy-MM-dd HH\:mm\:ss} ${event-properties:item=Message} ${when:when='${event-properties:item=Echo}' == true:inner=-&gt;:else=&lt;-} ${event-properties:item=SteamID}" />
  </targets>

  <rules>
    <logger name="*" minlevel="Debug" writeTo="ColoredConsole" />
    <logger name="MainAccount" level="Trace" writeTo="ChatLogFile">
      <filters defaultAction="Log">
        <when condition="not starts-with('${message}','OnIncoming') and not starts-with('${message}','SendMessage')" action="Ignore" />
      </filters>
    </logger>
  </rules>
</nlog>

저희는 기본 ColoredConsole 예시에서부터 시작하여, 이를 한층 더 확장했습니다. 가장 먼저, 그룹 채널과 Steam 사용자별로 영구적인 채팅 로그 파일을 준비했습니다 - 이는 ASF가 저희에게 세련된 방식으로 제공하는 추가 속성 덕분에 가능한 일입니다. 또한 현재 날짜, 메시지 내용, 발신/수신 정보, 그리고 Steam 사용자 자체만을 기록하는 커스텀 레이아웃을 사용하기로 결정했습니다. 마지막으로, 저희의 채팅 로깅 규칙을 오직 Trace 레벨에서만, 오직 MainAccount 봇에서만, 그리고 채팅 로깅과 관련된 함수(메시지 수신 및 에코를 위한 OnIncoming*, ASF 메시지 발신을 위한 SendMessage*)에서만 활성화했습니다.

위 예시는 **ArchiBot**과 대화할 때 logs/chat/0-0-76561198069026042.txt 파일을 생성합니다:

2018-07-26 01:38:38 how are you doing? -> 76561198069026042
2018-07-26 01:38:38 I'm doing great, how about you? <- 76561198069026042

물론 이는 단순한 작동 예시일 뿐이지만, 실용적인 방식으로 몇 가지 유용한 레이아웃 활용 기법을 보여드리고 있습니다. 이 아이디어는 추가 필터링, 사용자 지정 순서, 개인 레이아웃, 받은 메시지만 기록하는 기능 등 필요에 따라 얼마든지 확장할 수 있습니다.

다른 예시

이 예시는 SteamTarget을 사용해 메인 봇의 steamID(76561198006963719)로 메시지를 보내며, 이는 archi라는 이름의 봇이 기부 거래를 받았을 때 실행됩니다. 이 과정에는 또 다른 봇이 필요합니다(자기 자신에게는 메시지를 보낼 수 없기 때문입니다).

<?xml version="1.0" encoding="utf-8" ?>
<nlog xmlns="https://nlog-project.org/schemas/NLog.xsd" xsi:schemaLocation="NLog NLog.xsd" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance">
  <targets>
    <target type="Steam" name="Steam" steamID="76561198006963719" />
  </targets>

  <rules>
    <logger name="archi" level="Trace" writeTo="Steam">
      <filters defaultAction="Ignore">
        <when condition="starts-with('${message}','ParseTrade() Accepted donation trade: ')" action="Log" />
      </filters>
    </logger>
  </rules>
</nlog>

---

ASF Target

위에서 설명한 ColoredConsole, File과 같은 표준 NLog 로깅 대상 외에도, 사용자 지정 ASF 로깅 대상을 사용할 수 있습니다.

완전성을 최대화하기 위해, ASF Target의 정의는 NLog 문서 규칙을 따릅니다.

---

SteamTarget

짐작하셨겠지만, 이 대상은 ASF 메시지를 기록하기 위해 Steam 채팅 메시지를 사용합니다. 그룹 채팅 또는 개인 채팅 중 하나를 사용하도록 설정할 수 있습니다. 메시지의 Steam 대상을 지정하는 것 외에도, 해당 메시지를 보낼 봇의 botName을 지정할 수 있습니다.

ASF에서 사용되는 모든 환경에서 지원됩니다.

---

구성 구문

<targets>
  <target type="Steam"
          name="String"
          layout="Layout"
          chatGroupID="Ulong"
          steamID="Ulong"
          botName="Layout" />
</targets>

구성 파일(Configuration File) 사용에 대해 더 알아보세요.

---

매개변수

일반 옵션

name - 대상의 이름입니다.

---

레이아웃 옵션

layout - 렌더링될 텍스트입니다. Layout 필수 항목입니다. 기본값: ${level:uppercase=true}|${logger}|${message}

---

SteamTarget 옵션

chatGroupID - 64비트 long unsigned integer로 선언된 그룹 채팅의 ID입니다. 필수 항목이 아닙니다. 기본값은 0이며, 이 경우 그룹 채팅 기능이 비활성화되고 대신 개인 채팅이 사용됩니다. 활성화된 경우(0이 아닌 값으로 설정된 경우), 아래의 steamID 속성은 chatID로 작동하며, 봇이 메시지를 보낼 이 chatGroupID 내 채널의 ID를 지정합니다.

steamID - 64비트 long unsigned integer로 선언된 대상 Steam 사용자의 SteamID(예: SteamOwnerID) 또는 chatGroupID가 설정된 경우 대상 chatID입니다. 필수 항목입니다. 기본값은 0이며, 이 경우 로깅 대상이 완전히 비활성화됩니다.

botName - 위에서 선언한 steamID로 메시지를 보낼 봇의 이름입니다(ASF가 인식하는 이름으로, 대소문자를 구분합니다). 필수 항목이 아닙니다. 기본값은 null이며, 이 경우 현재 연결된 봇 중 **임의의 봇(any)**이 자동으로 선택됩니다. SteamTarget은 대상의 steamID가 친구 목록에 있어야 한다는 등 여러 Steam 제한 사항을 고려하지 않으므로, 이 값을 적절히 설정하는 것이 좋습니다. 이 변수는 layout 타입으로 정의되어 있으므로, 메시지를 생성한 봇을 사용하기 위한 ${logger}와 같은 특수 구문을 사용할 수 있습니다.

---

SteamTarget 예시

MyBot이라는 이름의 봇에서 발생한 Debug 레벨 이상의 모든 메시지를 steamID 76561198006963719로 전송하려면, 아래와 유사한 NLog.config를 사용해야 합니다:

<?xml version="1.0" encoding="utf-8" ?>
<nlog xmlns="https://nlog-project.org/schemas/NLog.xsd" xsi:schemaLocation="NLog NLog.xsd" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance">
  <targets>
    <target type="Steam" name="Steam" steamID="76561198006963719" botName="MyBot" />
  </targets>

  <rules>
    <logger name="*" minlevel="Debug" writeTo="Steam" />
  </rules>
</nlog>

참고: SteamTarget은 사용자 지정 대상이므로, xsi:type="Steam"이 아니라 type="Steam"으로 선언해야 합니다. xsi는 NLog가 공식적으로 지원하는 대상을 위해 예약되어 있습니다.

위와 유사한 NLog.config로 ASF를 실행하면, MyBot이 모든 일반적인 ASF 로그 메시지를 Steam 사용자 76561198006963719에게 전송하기 시작합니다. 메시지를 보내려면 MyBot이 연결되어 있어야 하므로, 봇이 Steam 네트워크에 연결되기 전에 발생한 초기 ASF 메시지는 전달되지 않는다는 점에 유의하세요.

물론 SteamTarget은 일반적인 TargetWithLayout에서 기대할 수 있는 모든 전형적인 기능을 갖추고 있으므로, 사용자 지정 레이아웃, 이름, 고급 로깅 규칙 등과 함께 사용할 수 있습니다. 위 예시는 가장 기본적인 예시일 뿐입니다.

---

스크린샷

---

주의 사항

ASF 프로세스에 참여 중인 steamID와 함께 SteamTarget에서 Debug 로깅 레벨 이하를 결합하려는 경우 주의하세요. 이 경우 ASF가 특정 메시지를 수신한 뒤 이를 Steam을 통해 기록하고, 그로 인해 다시 기록해야 할 메시지가 생성되는 무한 루프가 발생하여 StackOverflowException이 발생할 수 있습니다. 현재 이러한 상황이 발생할 수 있는 유일한 경우는 Trace 레벨(ASF가 자체 채팅 메시지를 기록하는 경우)을 기록하거나, ASF를 Debug 모드로 실행하는 동안 Debug 레벨(ASF가 모든 Steam 패킷을 기록하는 경우)을 기록하는 경우입니다.

요약하면, steamID가 동일한 ASF 프로세스에 참여하고 있는 경우, SteamTarget의 minlevel 로깅 레벨은 Info(ASF를 Debug 모드로 실행하지 않는다면 Debug도 가능) 이상이어야 합니다. 레벨을 수정하는 것이 상황에 맞지 않는다면, 무한 로깅 루프를 피하기 위해 자체 <when> 로깅 필터를 정의할 수도 있습니다. 이 주의 사항은 그룹 채팅에도 적용됩니다.

---

HistoryTarget

이 대상은 **ASF API**의 /Api/NLog 엔드포인트에서 고정 크기의 로깅 기록(history)을 제공하기 위해 ASF 내부적으로 사용되며, 이후 ASF-ui 및 기타 도구에서 이를 활용할 수 있습니다. 일반적으로 이 대상은 다른 사용자 지정을 위해 이미 커스텀 NLog config를 사용 중이고, ASF API(예: ASF-ui)에 로그를 노출하고자 할 때만 정의하면 됩니다. 저장된 메시지의 기본 레이아웃이나 maxCount를 수정하고 싶을 때도 선언할 수 있습니다.

ASF에서 사용되는 모든 환경에서 지원됩니다.

---

구성 구문

<targets>
  <target type="History"
          name="String"
          layout="Layout"
          maxCount="Byte" />
</targets>

구성 파일(Configuration File) 사용에 대해 더 알아보세요.

---

매개변수

일반 옵션

name - 대상의 이름입니다.

---

레이아웃 옵션

layout - 렌더링될 텍스트입니다. Layout 필수 항목입니다. 기본값: ${date:format=yyyy-MM-dd HH\:mm\:ss}|${processname}-${processid}|${level:uppercase=true}|${logger}|${message}${onexception:inner= ${exception:format=toString,Data}}

---

HistoryTarget 옵션

maxCount - 온디맨드 기록(on-demand history)을 위해 저장되는 로그의 최대 개수입니다. 필수 항목이 아닙니다. 기본값은 20이며, 이는 초기 기록을 제공하면서도 저장 요구사항에 따른 메모리 사용량을 고려했을 때 적절한 균형점입니다. 0보다 커야 합니다.