SiteLogFile Class1
Configura o registro em log para um site.
Sintaxe
class SiteLogFile : EmbeddedObject
Métodos
Essa classe não contém métodos.
Propriedades
A tabela a seguir lista as propriedades expostas pela classe SiteLogFile.
| Nome | Descrição |
|---|---|
CustomLogPluginClsid |
Um valor de leitura/gravação string que especifica o GUID de um módulo de plug-in usado para registro em log personalizado. O padrão é "FF160663-DE82-11CF-BC0A-00AA006111E0". |
Directory |
Um valor string de leitura/gravação não vazio que especifica o nome do diretório onde os arquivos de log são armazenados. O padrão é "%SystemDrive%\inetpub\logs\LogFiles". Observação: se o grupo IIS_IUSRS não tiver permissão para gravar nesse diretório, os logs não serão gerados. Se você especificar um diretório diferente do padrão, verifique se o grupo IIS_IUSRS tem permissão para gravar nele. |
Enabled |
Um valor boolean de leitura/gravação. true se o registrar em log do site estiver habilitado para um site; caso contrário, false. O padrão é true. |
LocalTimeRollover |
Um valor boolean de leitura/gravação. true se um novo arquivo de log for baseado na hora local, false se for baseado em UTC (Tempo Universal Coordenado). O padrão é false. |
LogExtFileFlags |
Um valor sint32 de leitura/gravação contendo uma máscara que especifica os atributos a serem registrados no arquivo de log. Essa propriedade se aplica somente ao registro em log de formato do W3C (World Wide Web Consortium). Os valores possíveis estão listados posteriormente na seção Comentários. |
LogFormat |
Uma enumeração sint32 de leitura/gravação que especifica o formato do arquivo de log. Os valores possíveis estão listados posteriormente na seção Comentários. |
Period |
Uma enumeração sint32 de leitura/gravação que especifica com que frequência o conteúdo do arquivo de log é substituído (ou seja, o arquivo de log atual é fechado e um novo arquivo de log é iniciado). Os valores possíveis estão listados posteriormente na seção Comentários. |
TruncateSize |
Um valor string de leitura/gravação que especifica o tamanho, em bytes, em que o conteúdo do arquivo de log será truncado. Para habilitar essa propriedade, defina Period como MaxSize. O tamanho deverá estar entre 1048576 (1 megabyte) e 4294967295 (4 gigabytes). O padrão é 20971520 (20 megabytes). |
Subclasses
Essa classe não contém subclasses.
Comentários
As instâncias dessa classe estão contidas na propriedade LogFile das classes Site e SiteElementDefaults.
A tabela a seguir lista os possíveis valores da propriedade LogExtFileFlags. Os atributos padrão são ClientIP, Date, HttpStatus, HttpSubStatus, Method, ServerIP, ServerPort, Time, UriQuery, UriStem, UserAgent, UserName e Win32Status.
| Valor | Atributo |
|---|---|
| 1 | Date |
| 2 | Time |
| 4 | ClientIP |
| 8 | UserName |
| 16 | SiteName |
| 32 | ComputerName |
| 64 | ServerIP |
| 128 | Method |
| 256 | UriStem |
| 512 | UriQuery |
| 1024 | HttpStatus |
| 2.048 | Win32Status |
| 4096 | BytesSent |
| 8192 | BytesRecv |
| 16384 | TimeTaken |
| 32768 | ServerPort |
| 65536 | UserAgent |
| 131072 | Cookie |
| 262144 | Referer |
| 524288 | ProtocolVersion |
| 1048576 | Host |
| 2097152 | HttpSubStatus |
A tabela a seguir lista os possíveis valores da propriedade LogFormat. O padrão é 2 (W3C).
| Valor | Palavra-chave | Descrição |
|---|---|---|
| 0 | IIS |
O arquivo de log registra no formato do IIS. Esse formato é um texto de ASCII fixo e não é personalizável. |
| 1 | NCSA |
O arquivo de log registra no formato de arquivo de log comum do NCSA (National Center for Supercomputing Applications). Esse formato é um texto de ASCII fixo e não é personalizável. |
| 2 | W3C |
Os registros de arquivo de log no formato de arquivo de log estendido W3C. Este formato está em texto ASCII e é personalizável. |
| 3 | Custom |
O arquivo de log registra em um formato personalizado decidido pelo usuário. |
A tabela a seguir lista os possíveis valores da propriedade Period. O padrão é 1 (Daily).
| Valor | Palavra-chave | Descrição |
|---|---|---|
| 0 | MaxSize |
O arquivo de log fechará e um novo arquivo de log iniciará quando o valor em TruncateSize for alcançado. |
| 1 | Daily |
O arquivo de log fechará e um novo arquivo de log iniciará uma vez por dia. |
| 2 | Weekly |
O arquivo de log fechará e um novo arquivo de log iniciará uma vez por semana. |
| 3 | Monthly |
O arquivo de log fechará e um novo arquivo de log iniciará uma vez por mês. |
| 4 | Hourly |
O arquivo de log fechará e um novo arquivo de log iniciará uma vez por hora. |
Hierarquia de herança
SiteLogFile
Requisitos
| Tipo | Descrição |
|---|---|
| Cliente | – IIS 7.0 no Windows Vista – IIS 7.5 no Windows 7 – IIS 8.0 no Windows 8 – IIS 10.0 no Windows 10 |
| Servidor | – IIS 7.0 no Windows Server 2008 – IIS 7.5 no Windows Server 2008 R2 – IIS 8.0 no Windows Server 2012 – IIS 8.5 no Windows Server 2012 R2 – IIS 10.0 no Windows Server 2016 |
| Product | – IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 |
| Arquivo MOF | WebAdministration.mof |
Confira também
Classe CentralBinaryLogFile
Classe CentralW3CLogFile
Classe EmbeddedObject
Classe LogSection
Classe Site
Classe SiteElementDefaults
Formatos de Arquivo de Log no IIS