웹 사이트 <로그파일의 로그 파일>
개요
<logFile> 요소의 <site> 요소에는 IIS 7 이상에서 사이트에 대한 로깅을 구성할 수 있는 특성이 포함되어 있습니다.
예를 들어 로깅을 사용하거나 사용하지 않도록 설정하고, IIS 로그 파일의 형식을 구성하고, 로그 파일에 저장할 정보 범주를 지정하고, 로그 파일이 저장된 디렉터리를 변경할 수 있습니다. 또한 요소를 사용하여 IIS가 <logFile> 로그 파일 크기 또는 시간 간격 및 로그 파일이 될 수 있는 최대 크기(바이트)에 따라 새 로그 파일을 만드는 빈도를 제어할 수 있습니다.
기본적으로 IIS 7 이상에서는 W3C(World Wide Web Consortium) 로그 파일 형식을 사용합니다. logFormat 특성을 IIS, NCSA 또는 Custom으로 수정하여 이 설정을 변경할 수 있습니다.
참고
ODBC 로깅은 IIS 7 이상에서 사용자 지정 로깅 모듈로 구현됩니다. 따라서 IIS 7 이상에서 ODBC 로깅을 사용하도록 설정하고 구성하는 작업은 다음과 같은 두 가지 개별 작업으로 구성됩니다.
- 요소에서 ODBC 로깅 특성
<odbcLogging>설정 이러한 특성은 ODBC 연결에 대한 DSN(시스템 데이터 원본 이름), 테이블 이름, 사용자 이름 및 암호를 지정합니다. - 요소에서 올바른 사용자 지정 로깅 특성
<logFile>설정 이러한 특성은 로그 파일 형식을 "사용자 지정"으로 설정하고 사용자 지정 로그 플러그 인 클래스 ID를 "{FF16065B-DE82-11CF-BC0A-00AA006111E0}"으로 설정해야 합니다.
ODBC 로깅에 대한 자세한 내용은 요소를 참조 <odbcLogging> 하세요.
logExtFileFlags 특성을 편집하여 IIS에서 기록하는 정보의 범주를 정의할 수 있습니다. 기본값은 Date, , Time, ClientIP, UserName, ServerIP, Method, UriStemUriQuery, TimeTaken, HttpStatus, Win32Status, , ServerPort, UserAgent, HttpSubStatus및 입니다Referer.
참고
<logFile> 요소가 섹션과 <site> 특정 사이트에 대한 섹션 모두에서 <siteDefaults> 구성된 경우 섹션의 <site> 구성이 해당 사이트에 사용됩니다.
IIS 8.5를 사용하면 표준 로그 집합 외에 사용자 지정 필드를 기록할 수 있습니다. 사용자 지정 필드를 추가하려면 로그 파일 형식이 W3C여야 합니다. 자세한 내용은 customFields를 참조하세요.
호환성
| 버전 | 참고 |
|---|---|
| IIS 10.0 | <logFile> 요소가 IIS 10.0에서 수정되지 않았습니다. |
| IIS 8.5 | flushByEntryCountW3CLog 로그 파일로 플러시되기 전에 버퍼에 저장할 이벤트 수를 지정하는 특성을 추가했습니다. logTargetW3C 로깅된 IIS 이벤트가 처리되는 방법을 지정하는 특성을 추가했습니다. 로그 파일에서 maxLogLineLength 줄의 최대 길이를 지정하는 특성을 추가했습니다. 자식 요소를 추가했습니다 <customFields> . |
| IIS 8.0 | 특성이 logSiteId 추가되어 -sitename 필드의 내용을 지정하고 referer 플래그가 특성의 logExtFileFlags 기본값에 추가되었습니다. |
| IIS 7.5 | <logFile> 요소가 IIS 7.5에서 수정되지 않았습니다. |
| IIS 7.0 | <logFile> 요소의 <site> 요소는 IIS 7.0에서 도입되었습니다. |
| IIS 6.0 | 요소는 <logFile> IIS 6.0 IIsWebService 메타베이스 개체의 로깅 속성 섹션을 대체합니다. |
설치 프로그램
요소는 <logFile> IIS 7 이상의 기본 설치에 포함됩니다.
방법
사이트의 로깅 설정을 편집하는 방법
IIS(인터넷 정보 서비스) 관리자를 엽니다.
Windows Server 2012 또는 Windows Server 2012 R2를 사용하는 경우:
- 작업 표시줄에서 서버 관리자 클릭하고 도구를 클릭한 다음 IIS(인터넷 정보 서비스) 관리자를 클릭합니다.
Windows 8 또는 Windows 8.1 사용하는 경우:
- Windows 키를 누른 채로 문자 X를 누른 다음 제어판 클릭합니다.
- 관리 도구를 클릭한 다음 IIS(인터넷 정보 서비스) 관리자를 두 번 클릭합니다.
Windows Server 2008 또는 Windows Server 2008 R2를 사용하는 경우:
- 작업 표시줄에서 시작을 클릭하고 관리 도구를 가리킨 다음 IIS(인터넷 정보 서비스) 관리자를 클릭합니다.
Windows Vista 또는 Windows 7을 사용하는 경우:
- 작업 표시줄에서 시작을 클릭한 다음 제어판 클릭합니다.
- 관리 도구를 두 번 클릭한 다음 IIS(인터넷 정보 서비스) 관리자를 두 번 클릭합니다.
연결 창에서 서버 이름을 확장하고 사이트를 확장한 다음 로깅을 구성할 웹 사이트를 클릭합니다.
홈 창에서 로깅을 두 번 클릭합니다.
로깅 창에서 서식 상자에서 로그 파일 형식을 선택한 다음 디렉터리 상자에 로그 파일을 저장하는 디렉터리의 경로를 입력하거나 찾아보기...를 클릭하여 로그 파일을 저장할 디렉터리를 선택합니다.
W3C 로그 파일 형식을 사용하도록 선택한 경우:
- 필드 선택을 클릭하여 기록할 정보 유형을 선택합니다.
- W3C 로깅 필드 대화 상자에서 기록하려는 옵션에 대한 검사 상자를 선택하고, 기록하지 않으려는 옵션에 대한 검사 상자를 지운 다음 확인을 클릭합니다.
W3C 로그에 대한 ETW 또는 파일 로깅을 구성하는 방법
IIS(인터넷 정보 서비스) 관리자를 엽니다.
Windows Server 2012 R2를 사용하는 경우:
- 작업 표시줄에서 서버 관리자 클릭하고 도구를 클릭한 다음 IIS(인터넷 정보 서비스) 관리자를 클릭합니다.
Windows 8.1 사용하는 경우:
- Windows 키를 누른 채로 문자 X를 누른 다음 제어판 클릭합니다.
- 관리 도구를 클릭한 다음 IIS(인터넷 정보 서비스) 관리자를 두 번 클릭합니다.
연결 창에서 서버 이름을 확장하고 사이트를 확장한 다음 사이트를 선택합니다.
사이트의 홈 창에서 로깅을 두 번 클릭합니다.
로깅 홈페이지의 로그 이벤트 대상에서 로그 파일만, ETW 이벤트만 또는 로그 파일 및 ETW 이벤트 모두를 선택합니다.
항목 수별로 W3C 로그 플러시를 구성하는 방법
IIS(인터넷 정보 서비스) 관리자를 엽니다.
Windows Server 2012 R2를 사용하는 경우:
- 작업 표시줄에서 서버 관리자 클릭하고 도구를 클릭한 다음 IIS(인터넷 정보 서비스) 관리자를 클릭합니다.
Windows 8.1 사용하는 경우:
- Windows 키를 누른 채로 문자 X를 누른 다음 제어판 클릭합니다.
- 관리 도구를 클릭한 다음 IIS(인터넷 정보 서비스) 관리자를 두 번 클릭합니다.
연결 창에서 서버를 확장한 다음 구성 편집기를 두 번 클릭합니다.
구성 편집기에서 섹션에 대해 를 확장
system.applicationHost한 다음 사이트를 선택합니다.(컬렉션)을 클릭한 다음 줄임표를 클릭합니다.
구성할 사이트를 선택한 다음 logFile을 확장합니다.
flushByEntryCountW3Clog의 경우 로그 파일로 플러시되기 전에 버퍼에 저장할 이벤트 수를 입력합니다.
작업 창에서 적용을 클릭합니다.
최대 로그 줄 길이를 구성하는 방법
IIS(인터넷 정보 서비스) 관리자를 엽니다.
Windows Server 2012 R2를 사용하는 경우:
- 작업 표시줄에서 서버 관리자 클릭하고 도구를 클릭한 다음 IIS(인터넷 정보 서비스) 관리자를 클릭합니다.
Windows 8.1 사용하는 경우:
- Windows 키를 누른 채로 문자 X를 누른 다음 제어판 클릭합니다.
- 관리 도구를 클릭한 다음 IIS(인터넷 정보 서비스) 관리자를 두 번 클릭합니다.
연결 창에서 서버를 확장한 다음 구성 편집기를 두 번 클릭합니다.
구성 편집기에서 섹션에 대해 를 확장
system.applicationHost한 다음 사이트를 선택합니다.(컬렉션)을 클릭한 다음 줄임표를 클릭합니다.
구성할 사이트를 선택한 다음 logFile을 확장합니다.
maxLogLineLength의 경우 로그 파일의 한 줄에 최대 바이트 수를 입력합니다.
작업 창에서 적용을 클릭합니다.
구성
특성
| attribute | Description | ||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
customLogPluginClsid |
선택적 문자열 특성입니다. 사용자 지정 모듈의 우선 순위에 따라 CLSID(COM 개체 클래스 ID) 또는 ID를 지정합니다. |
||||||||||||||||||||||||||||||||||||||||||||||
directory |
선택적 문자열 특성입니다. 로그 파일 및 로깅 관련 지원 파일이 저장되는 로깅 디렉터리를 지정합니다. 기본값은 %SystemDrive%\inetpub\logs\LogFiles입니다. |
||||||||||||||||||||||||||||||||||||||||||||||
enabled |
선택적 부울 특성입니다. 사이트에 대해 로깅을 사용할 수 있는지(true) 또는 사용 안 함(false)을 지정합니다. 참고: ASP 및 ODBC 오류는 IIS 로그 파일에 기록되지 않습니다. 기본값은 true입니다. |
||||||||||||||||||||||||||||||||||||||||||||||
flushByEntryCountW3CLog |
선택적 uint 특성입니다. 버퍼가 로그 파일로 플러시되기 전에 버퍼에 저장할 이벤트 수를 지정합니다. 숫자가 낮을수록 더 많은 수의 디스크 작업으로 인해 성능이 저하되어 이벤트가 더 빠르게 플러시됩니다. 실시간 문제 해결을 위해 이 값을 줄이고 성능을 향상시킵니다. 값은 0 플러시가 기본 최대 64k에서 발생되도록 지정합니다.기본값은 0입니다. |
||||||||||||||||||||||||||||||||||||||||||||||
localTimeRollover |
선택적 부울 특성입니다. 새 로그 파일이 현지 시간을 기준으로 생성되는지 또는 이전에 GMT(그리니치 표준시)라고 불렸던 UTC(협정 세계시)를 기반으로 만들지 여부를 지정합니다. false이면 UTC를 기반으로 새 로그 파일이 만들어집니다. 참고: 설정에 관계없이 각 W3C 확장 로깅 로그 레코드에 대한 타임스탬프는 UTC 기반입니다. 기본값은 false입니다. |
||||||||||||||||||||||||||||||||||||||||||||||
logExtFileFlags |
선택적 flags 특성입니다. 로그 파일(W3C 확장 로그 파일 형식을 사용하는 경우) 또는 사이트에 대한 이벤트를 로깅하는 동안 ODBC 데이터 원본에 기록되는 정보의 범주를 지정합니다. logExtFileFlags 특성은 다음 값 중 하나 이상일 수 있습니다. 둘 이상의 값을 지정하는 경우 쉼표(,)로 구분합니다. 기본값은 , , Time, ClientIP, UserName, ServerIP, Method, UriStem, UriQuery, TimeTaken, , HttpStatus, Win32Status, ServerPort, UserAgent, , HttpSubStatus, Referer입니다Date.
|
||||||||||||||||||||||||||||||||||||||||||||||
logFormat |
선택적 열거형 특성입니다. 로그 파일 형식을 지정합니다. logFormat 특성은 다음 값 중 하나일 수 있습니다. 기본값은 W3C입니다.
|
||||||||||||||||||||||||||||||||||||||||||||||
logSiteId |
선택적 부울 특성입니다. s-sitename 필드에 사이트 이름(false) 또는 사이트 ID(true)가 포함되도록 지정합니다. 속성당 하나의 로그 파일(기본값)으로 Site 설정된 경우 로그 파일 이름 속성에 사이트 ID가 대신 포함되므로 기본적으로 로그 파일에 s-sitename 열이 표시되지 않습니다. 속성당 하나의 로그 파일이 로 Server설정된 경우 기본적으로 s-sitename 열이 로그 파일에 포함됩니다.기본값은 입니다 True. 즉, s-sitename 필드에 사이트 ID가 포함됩니다. 대신 사이트 이름을 기록하려면 logSiteID를 로 False설정합니다. |
||||||||||||||||||||||||||||||||||||||||||||||
logTargetW3C |
선택적 Flags 특성입니다. IIS가 기록된 IIS 이벤트를 처리하기 위해 ETW(Windows용 이벤트 추적) 및/또는 파일 로깅을 사용할지 여부를 지정합니다. ETW는 ETW 공급자 및 표준 쿼리 메커니즘의 실시간 로깅 및 사용을 제공합니다. 파일 로깅은 로깅 데이터에 액세스하기 위해 구문 분석할 수 있는 이벤트 데이터를 텍스트 파일에 저장합니다. IIS에서 로그 파일을 사용하는 경우 HTTP.sys 트랜잭션이 완료된 후 데이터를 텍스트 로그 파일에 직접 기록합니다. ETW를 사용하는 경우 HTTP.sys iislogging 공급자를 사용하여 ETW로 데이터를 보내고, LOGSVC 서비스는 ETW에서 데이터를 쿼리하고, 작업자 프로세스에서 직접 데이터를 수집하고, 데이터를 로그 파일로 보내는 등 로그 데이터를 관리합니다. 특성에는 logTargetW3C 다음과 같은 가능한 값이 있을 수 있습니다. 기본값은 File입니다. 및 가 모두 applicationHost.config 사이트에 대해 logTargetW3C 나열되는 경우 이는 IIS 관리자의 로깅 창에서 사이트의 로그 파일 설정에 대해 로그 파일 및 ETW 이벤트를 모두 선택하는 것과 같습니다.ETWFile
|
||||||||||||||||||||||||||||||||||||||||||||||
maxLogLineLength |
선택적 uint 특성입니다. 로그 파일에서 줄의 최대 길이를 지정합니다. 이렇게 하면 로깅을 통해 누적된 데이터의 양을 제한하고, 특히 사용자 지정 로깅 필드를 추가할 때 디스크 공간을 절약할 수 있습니다. 범위는 2에서 65,536까지입니다. 기본값은 65536입니다. |
||||||||||||||||||||||||||||||||||||||||||||||
period |
선택적 열거형 특성입니다. IIS가 새 로그 파일을 만드는 빈도를 지정합니다. period 특성은 다음과 같은 가능한 값 중 하나일 수 있습니다. 기본값은 Daily입니다.
|
||||||||||||||||||||||||||||||||||||||||||||||
truncateSize |
선택적 int64 특성입니다. 새 로그 파일을 만들 로그 파일의 최대 크기(바이트)를 지정합니다. 이 값은 기간 특성에 대해 MaxSize를 선택한 경우에만 적용됩니다. 최소 파일 크기는 1,048,576바이트입니다. 이 특성이 1,048,576바이트 미만의 값으로 설정된 경우 기본값은 암시적으로 1,048,576바이트로 간주됩니다. 기본값은 20971520입니다. |
자식 요소
| 요소 | Description |
|---|---|
customFields |
선택적 요소입니다. W3C 로그의 사용자 지정 필드 컬렉션에 대한 구성 설정을 지정합니다. |
구성 샘플
다음 구성 예제에서는 요소의 <logFile>logExtFileFlags 특성을 사용하여 Contoso라는 웹 사이트에 대해 IIS가 기록하는 설정을 지정합니다. 기간 특성으로 인해 IIS는 매시간 새 W3C 로그 파일을 만듭니다. localTimeRollover 특성은 IIS가 로컬 서버의 시간을 사용하여 새 로그 파일을 만들고 이름을 지정할 시기를 결정하도록 지정합니다.
<site name="Contoso" id="2" serverAutoStart="true">
<application path="/" applicationPool="Contoso">
<virtualDirectory path="/" physicalPath="C:\Contoso\Content" />
</application>
<bindings>
<binding protocol="http" bindingInformation="*:80:www.contoso.com" />
</bindings>
<logFile
period="Hourly"
localTimeRollover="true"
logExtFileFlags="Date, Time, ClientIP, UserName, ServerIP, Method, UriStem, UriQuery, HttpStatus, TimeTaken, ServerPort, UserAgent, HttpSubStatus" />
</site>
샘플 코드
다음 예제에서는 Contoso라는 사이트에 대한 로깅을 구성합니다. 각 예제에서는 사이트에 대한 로깅을 사용하도록 설정하고 매일 새 로그 파일을 생성하도록 사이트 로깅을 구성합니다. 또한 로컬 서버의 시간을 사용하여 로그 파일 이름을 생성하고 새 로그 파일을 생성할 시기를 결정하도록 IIS를 구성합니다.
AppCmd.exe
appcmd.exe set config -section:system.applicationHost/sites /[name='Contoso'].logFile.logFormat:"W3C"
appcmd.exe set config -section:system.applicationHost/sites /[name='Contoso'].logFile.period:"Daily"
appcmd.exe set config -section:system.applicationHost/sites /[name='Contoso'].logFile.localTimeRollover:"True"
appcmd.exe set config -section:system.applicationHost/sites /[name='Contoso'].logFile.enabled:"True" /commit:apphost
참고
AppCmd.exe 사용하여 이러한 설정을 구성할 때 커밋 매개 변수 apphost 를 로 설정해야 합니다. 그러면 구성 설정이 ApplicationHost.config 파일의 적절한 위치 섹션에 커밋됩니다.
C#
using System;
using System.Text;
using Microsoft.Web.Administration;
internal static class Sample
{
private static void Main()
{
using (ServerManager serverManager = new ServerManager())
{
Configuration config = serverManager.GetApplicationHostConfiguration();
ConfigurationSection sitesSection = config.GetSection("system.applicationHost/sites");
ConfigurationElementCollection sitesCollection = sitesSection.GetCollection();
ConfigurationElement siteElement = FindElement(sitesCollection, "site", "name", @"Contoso");
if (siteElement == null) throw new InvalidOperationException("Element not found!");
ConfigurationElement logFileElement = siteElement.GetChildElement("logFile");
logFileElement["logFormat"] = @"W3C";
logFileElement["period"] = @"Daily";
logFileElement["localTimeRollover"] = true;
logFileElement["enabled"] = true;
serverManager.CommitChanges();
}
}
private static ConfigurationElement FindElement(ConfigurationElementCollection collection, string elementTagName, params string[] keyValues)
{
foreach (ConfigurationElement element in collection)
{
if (String.Equals(element.ElementTagName, elementTagName, StringComparison.OrdinalIgnoreCase))
{
bool matches = true;
for (int i = 0; i < keyValues.Length; i += 2)
{
object o = element.GetAttributeValue(keyValues[i]);
string value = null;
if (o != null)
{
value = o.ToString();
}
if (!String.Equals(value, keyValues[i + 1], StringComparison.OrdinalIgnoreCase))
{
matches = false;
break;
}
}
if (matches)
{
return element;
}
}
}
return null;
}
}
VB.NET
Imports System
Imports System.Text
Imports Microsoft.Web.Administration
Module Sample
Sub Main()
Dim serverManager As ServerManager = New ServerManager
Dim config As Configuration = serverManager.GetApplicationHostConfiguration
Dim sitesSection As ConfigurationSection = config.GetSection("system.applicationHost/sites")
Dim sitesCollection As ConfigurationElementCollection = sitesSection.GetCollection
Dim siteElement As ConfigurationElement = FindElement(sitesCollection, "site", "name", "Contoso")
If (siteElement Is Nothing) Then
Throw New InvalidOperationException("Element not found!")
End If
Dim logFileElement As ConfigurationElement = siteElement.GetChildElement("logFile")
logFileElement("logFormat") = "W3C"
logFileElement("period") = "Daily"
logFileElement("localTimeRollover") = True
logFileElement("enabled") = True
serverManager.CommitChanges()
End Sub
Private Function FindElement(ByVal collection As ConfigurationElementCollection, ByVal elementTagName As String, ByVal ParamArray keyValues() As String) As ConfigurationElement
For Each element As ConfigurationElement In collection
If String.Equals(element.ElementTagName, elementTagName, StringComparison.OrdinalIgnoreCase) Then
Dim matches As Boolean = True
Dim i As Integer
For i = 0 To keyValues.Length - 1 Step 2
Dim o As Object = element.GetAttributeValue(keyValues(i))
Dim value As String = Nothing
If (Not (o) Is Nothing) Then
value = o.ToString
End If
If Not String.Equals(value, keyValues((i + 1)), StringComparison.OrdinalIgnoreCase) Then
matches = False
Exit For
End If
Next
If matches Then
Return element
End If
End If
Next
Return Nothing
End Function
End Module
JavaScript
var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";
var sitesSection = adminManager.GetAdminSection("system.applicationHost/sites", "MACHINE/WEBROOT/APPHOST");
var sitesCollection = sitesSection.Collection;
var siteElementPos = FindElement(sitesCollection, "site", ["name", "Contoso"]);
if (siteElementPos == -1) throw "Element not found!";
var siteElement = sitesCollection.Item(siteElementPos);
var logFileElement = siteElement.ChildElements.Item("logFile");
logFileElement.Properties.Item("logFormat").Value = "W3C";
logFileElement.Properties.Item("period").Value = "Daily";
logFileElement.Properties.Item("localTimeRollover").Value = true;
logFileElement.Properties.Item("enabled").Value = true;
adminManager.CommitChanges();
function FindElement(collection, elementTagName, valuesToMatch) {
for (var i = 0; i < collection.Count; i++) {
var element = collection.Item(i);
if (element.Name == elementTagName) {
var matches = true;
for (var iVal = 0; iVal < valuesToMatch.length; iVal += 2) {
var property = element.GetPropertyByName(valuesToMatch[iVal]);
var value = property.Value;
if (value != null) {
value = value.toString();
}
if (value != valuesToMatch[iVal + 1]) {
matches = false;
break;
}
}
if (matches) {
return i;
}
}
}
return -1;
}
VBScript
Set adminManager = createObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set sitesSection = adminManager.GetAdminSection("system.applicationHost/sites", "MACHINE/WEBROOT/APPHOST")
Set sitesCollection = sitesSection.Collection
siteElementPos = FindElement(sitesCollection, "site", Array("name", "Contoso"))
If siteElementPos = -1 Then
WScript.Echo "Element not found!"
WScript.Quit
End If
Set siteElement = sitesCollection.Item(siteElementPos)
Set logFileElement = siteElement.ChildElements.Item("logFile")
logFileElement.Properties.Item("logFormat").Value = "W3C"
logFileElement.Properties.Item("period").Value = "Daily"
logFileElement.Properties.Item("localTimeRollover").Value = True
logFileElement.Properties.Item("enabled").Value = True
adminManager.CommitChanges()
Function FindElement(collection, elementTagName, valuesToMatch)
For i = 0 To CInt(collection.Count) - 1
Set element = collection.Item(i)
If element.Name = elementTagName Then
matches = True
For iVal = 0 To UBound(valuesToMatch) Step 2
Set property = element.GetPropertyByName(valuesToMatch(iVal))
value = property.Value
If Not IsNull(value) Then
value = CStr(value)
End If
If Not value = CStr(valuesToMatch(iVal + 1)) Then
matches = False
Exit For
End If
Next
If matches Then
Exit For
End If
End If
Next
If matches Then
FindElement = i
Else
FindElement = -1
End If
End Function