전달 로거 만들기Creating Forwarding Loggers

전달 로거는 다중 프로세서 시스템에서 프로젝트를 빌드할 때 모니터링하려는 이벤트를 선택할 수 있도록 하여 로깅 효율성을 개선합니다.Forwarding loggers improve logging efficiency by letting you choose the events you want to monitor when you build projects on a multi-processor system. 전달 로거를 사용하여 원하지 않는 이벤트가 중앙 로거를 가득 채우고, 빌드 시간이 느려지고, 로그를 어지럽히지 않도록 방지할 수 있습니다.By enabling forwarding loggers, you can prevent unwanted events from overwhelming the central logger, slowing build time, and cluttering your log.

전달 로거를 만들려면 IForwardingLogger 인터페이스를 구현한 다음 해당 메서드를 수동으로 구현하거나, ConfigurableForwardingLogger 클래스 및 미리 구성된 해당 메서드를 사용할 수 있습니다.To create a forwarding logger, you can either implement the IForwardingLogger interface and then implement its methods manually, or use the ConfigurableForwardingLogger class and its pre-configured methods. (두 번째 방법은 대부분의 응용 프로그램에서 충분히 사용할 수 있습니다.)(The latter will suffice for most applications.)

등록 이벤트 및 해당 이벤트에 대한 응답Register Events and Respond to Them

전달 로거는 보조 빌드 엔진에서 빌드 이벤트를 보고할 때 이에 대한 정보를 수집합니다. 이 작업은 다중 프로세서 시스템에서 빌드하는 동안 기본 빌드 프로세스에 의해 만들어진 작업자 프로세스입니다.A forwarding logger gathers information about build events as they are reported by the secondary build engine, which is a worker process that is created by the main build process during a build on a multi-processor system. 그런 다음 전달 로거는 지정한 지침에 따라 중앙 로거에 전달할 이벤트를 선택합니다.Then the forwarding logger selects events to forward to the central logger, based on the instructions you have given it.

전달 로거를 등록하여 모니터링하려는 이벤트를 처리해야 합니다.You must register forwarding loggers to handle the events you want to monitor. 이벤트에 등록하려면 로거거 Initialize 메서드를 재정의해야 합니다.To register for events, loggers must override the Initialize method. 이 메서드에는 시스템의 프로세서 수로 설정할 수 있는 nodecount 선택적 매개 변수가 포함됩니다.This method now includes an optional parameter, nodecount, that can be set to the number of processors in the system. (기본적으로 값은 1입니다.)(By default, the value is 1.)

모니터링할 수 있는 이벤트의 예는 TargetStarted, ProjectStartedProjectFinished입니다.Examples of events you can monitor are TargetStarted, ProjectStarted, and ProjectFinished.

다중 프로세서 환경에서 이벤트 메시지는 순서 없이 수신될 가능성이 높습니다.In a multi-processor environment, event messages are likely to be received out of order. 따라서 전달 로거에서 이벤트 처리기를 사용하여 이벤트를 계산하고 중앙 로거에 전달하기 위해 리디렉터에 전달되는 이벤트를 확인하도록 프로그래밍해야 합니다.Therefore, you must evaluate the events by using the event handler in the forwarding logger and program it to determine which events to pass to the redirector for forwarding to the central logger. 이를 위해 모든 메시지에 연결된 BuildEventContext 클래스를 사용하여 전달하려는 이벤트를 식별한 다음 ConfigurableForwardingLogger 클래스(또는 그 하위 클래스)에 이벤트의 이름을 전달할 수 있습니다.To accomplish this, you can use the BuildEventContext class, which is attached to every message, to help identify events you want to forward, and then pass the names of the events to the ConfigurableForwardingLogger class (or a subclass of it). 이 방법을 사용하면 다른 특정 코딩이 이벤트를 전달해야 합니다.When you use this method, no other specific coding is required to forward events.

전달 로거 지정Specify a Forwarding Logger

전달 로거를 어셈블리로 컴파일한 후에 빌드하는 동안 MSBuildMSBuild에서 사용하도록 지시해야 합니다.After the forwarding logger has been compiled into an assembly, you must tell MSBuildMSBuild to use it during builds. 이를 위해 MSBuild.exe와 함께 /FileLogger, /FileLoggerParameters/DistributedFileLogger 스위치를 사용합니다.To do this, use the /FileLogger, /FileLoggerParameters, and /DistributedFileLogger switches together with MSBuild.exe. /FileLogger 스위치는 MSBuild.exe에서 로거를 직접 연결하도록 지시합니다.The /FileLogger switch tells MSBuild.exe that the logger is directly attached. /DistributedFileLogger 스위치는 노드당 로그 파일이 있음을 의미합니다.The /DistributedFileLogger switch means that there is a log file per node. 전달 로거에 매개 변수를 설정하려면 /FileLoggerParameters 스위치를 사용합니다.To set parameters on the forwarding logger, use the /FileLoggerParameters switch. 해당 스위치 및 기타 MSBuild.exe 스위치에 대한 자세한 내용은 명령줄 참조를 참조하세요.For more information about these and other MSBuild.exe switches, see Command-Line Reference.

다중 프로세서 인식 로거Multi-Processor-Aware Loggers

다중 프로세서 시스템에서 프로젝트를 빌드할 때 각 프로세서의 빌드 메시지가 통합 시퀀스에서 자동으로 인터리브되지 않습니다.When you build a project on a multi-processor system, the build messages from each processor are not automatically interleaved in a unified sequence. 대신 모든 메시지에 연결된 BuildEventContext 클래스를 사용하여 메시지 그룹화 우선 순위를 설정해야 합니다.Instead, you must establish a message grouping priority by using the BuildEventContext class that is attached to every message. 다중 프로세서 빌드에 대한 자세한 내용은 다중 프로세서 환경의 로깅을 참조하세요.For more information about multi-processor building, see Logging in a Multi-Processor Environment.

참고 항목See Also

빌드 로그 가져오기 Obtaining Build Logs
빌드 로거 Build Loggers
다중 프로세서 환경에서의 로그인Logging in a Multi-Processor Environment