Esta página foi traduzida pela API Cloud Translation.

Serviços de informações da Internet

A integração do Internet Information Services (IIS) recolhe telemetria dos seus servidores Web IIS. As métricas fornecem informações de ligação e também dados sobre bytes transferidos. A integração também recolhe informações dos registos de acesso.

Para mais informações sobre o IIS, consulte a documentação dos Serviços de Informação da Internet.

Antes de começar

A versão 2.15.0 do agente de operações introduz a compatibilidade com um novo conjunto de métricas do IIS que usam o prefixo workload.googleapis.com/. Tem de configurar o agente para recolher estas métricas, conforme descrito na configuração de exemplo.

O agente de operações sempre suportou um conjunto limitado de métricas do IIS; estas métricas usam o prefixo agent.googleapis.com/iis/. Não é necessária nenhuma configuração adicional para recolher estas métricas em VMs do Windows.

Este documento refere-se às métricas com o prefixo agent como métricas v1 e às métricas com o prefixo workload como métricas v2. Para ver tabelas destas métricas, consulte o artigo O que é monitorizado.

A partir da versão 2.15.0 do agente de operações, pode configurar o agente para recolher métricas v1, métricas v2 ou ambas.

Nota: se tiver alertas ou outras configurações criadas com base nas métricas da v1 e mudar para as métricas da v2, também tem de migrar as suas configurações. Se parar de recolher métricas da versão 1, os alertas e outra monitorização dessas métricas vão deixar de funcionar. A tabela seguinte mostra o mapeamento das métricas da v1 para as métricas da v2:

Métrica v1 (`agent.googleapis.com/iis/`)	Métrica v2 (`workload.googleapis.com/`)
`current_connections`	`iis.connection.active`
`network/transferred_bytes_count`	`iis.network.io`
`new_connection_count`	`iis.connection.attempt.count`
`request_count`	`iis.request.count`

Pré-requisitos

Para recolher telemetria do IIS, tem de instalar o agente de operações:

Para as métricas v1, instale a versão 1.0.0 ou superior.
Para as métricas v2, instale a versão 2.15.0 ou superior
Para registos, instale a versão 2.14.0 ou superior.

Esta integração suporta as versões 8.5 e 10.0 do IIS.

Configure o agente de operações para o IIS

Seguindo o guia para configurar o Ops Agent, adicione os elementos necessários para recolher telemetria de instâncias do IIS e reinicie o agente.

Exemplo de configuração

Os seguintes comandos criam a configuração para recolher e carregar telemetria para o IIS:

$ErrorActionPreference = 'Stop'

# This config gets merged with the built-in Ops Agent config, which already
# includes the v1 receiver in the default pipeline.
# Because the v2 receiver here uses a unique ID, it does not overwrite
# the default receiver and so both receivers will be active simultaneously
# during the test.

# Create an empty config.yaml file if it doesn't exist.
$configFilePath  = 'C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.yaml'

if (-not (Test-Path -Path $configFilePath -PathType Leaf)) {
    New-Item -ItemType File -Path $configFilePath -Force | Out-Null
}

# Create a back up of the existing file so existing configurations are not lost.
Copy-Item -Path 'C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.yaml' -Destination 'C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.yaml.bak'

# Configure the Ops Agent.
Add-Content 'C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.yaml' "
metrics:
  receivers:
    iis_v2:
      type: iis
      receiver_version: 2
  service:
    pipelines:
      iispipeline:
        receivers:
          - iis_v2
logging:
  receivers:
    iis_access:
      type: iis_access
  service:
    pipelines:
      iis:
        receivers:
        - iis_access
"

if (Get-Service google-cloud-ops-agent* -ErrorAction SilentlyContinue) {
  (Get-Service google-cloud-ops-agent*).WaitForStatus('Running', '00:03:00')
}

Para que estas alterações entrem em vigor, tem de reiniciar o agente de operações:

Estabeleça ligação à sua instância através do RDP ou de uma ferramenta semelhante e inicie sessão no Windows.
Abra um terminal do PowerShell com privilégios de administrador: clique com o botão direito do rato no ícone do PowerShell e selecione Executar como administrador
Para reiniciar o agente, execute o seguinte comando do PowerShell:
```
Restart-Service google-cloud-ops-agent -Force
```
Para confirmar que o agente foi reiniciado, execute o seguinte comando e verifique se os componentes "Agente de métricas" e "Agente de registo" foram iniciados:
```
Get-Service google-cloud-ops-agent*
```

Este recetor suporta apenas o formato de registo W3C predefinido.

Configure a recolha de registos

Para carregar registos de acesso do IIS, tem de criar recetores para os registos e, em seguida, criar um pipeline para os novos recetores.

Para configurar um recetor para os seus registos iis_access, especifique os seguintes campos:

Campo	Predefinição	Descrição
`exclude_paths`	`[]`	Uma lista de padrões de caminhos do sistema de ficheiros a excluir do conjunto correspondente a `include_paths`.
`include_paths`	`['C:\inetpub\logs\LogFiles\W3SVC1\u_ex*']`	Uma lista de caminhos do sistema de ficheiros a ler através da análise detalhada de cada ficheiro. Pode usar um caráter universal (``) nos caminhos; por exemplo, `C:\inetpub\logs\LogFiles\W3SVC1\u_ex`.
`type`		O valor tem de ser `iis_access`.
`record_log_file_path`	`false`	Se estiver definido como `true`, o caminho para o ficheiro específico a partir do qual o registo de registo foi obtido aparece na entrada de registo de saída como o valor da etiqueta `agent.googleapis.com/log_file_path`. Quando usa um caráter universal, apenas é registado o caminho do ficheiro a partir do qual o registo foi obtido.
`wildcard_refresh_interval`	`60s`	O intervalo no qual os caminhos de ficheiros com carateres universais em `include_paths` são atualizados. Especificado como um intervalo de tempo analisável por `time.ParseDuration`, por exemplo, 30s ou 2m. Esta propriedade pode ser útil em débitos de registo elevados, em que os ficheiros de registo são rodados mais rapidamente do que o intervalo predefinido.

O que é registado

O logName é derivado dos IDs do recetor especificados na configuração. Os campos detalhados no interior de LogEntry são os seguintes.

Os registos iis_access contêm os seguintes campos no LogEntry:

Campo	Tipo	Descrição
`httpRequest.referer`	de string	Conteúdo do cabeçalho `Referer`
`httpRequest.remoteIp`	de string	IP do cliente que fez o pedido
`httpRequest.requestMethod`	de string	Método HTTP
`httpRequest.requestUrl`	de string	URL do pedido (normalmente, apenas a parte do caminho do URL)
`httpRequest.serverIp`	de string	O IP e a porta do servidor que foram pedidos
`httpRequest.status`	número	Código de estado HTTP
`httpRequest.userAgent`	de string	Conteúdo do cabeçalho `User-Agent`
`jsonPayload.sc_substatus`	número	O código de erro de subestado
`jsonPayload.sc_win32_status`	número	O código de estado do Windows
`jsonPayload.time_taken`	número	O período de tempo que a ação demorou, em milissegundos
`jsonPayload.user`	de string	Nome de utilizador autenticado para o pedido
`timestamp`	string (`Timestamp`)	Hora em que o pedido foi recebido

Configure a recolha de métricas da v1

O agente de operações numa VM do Microsoft Windows recolhe automaticamente métricas do IIS v1. Não é necessária nenhuma configuração adicional. Para obter informações sobre a recolha apenas de métricas da v2, consulte o artigo Configure a recolha de métricas da v2.

Depois de configurar uma nova instância do IIS, o IIS pode não comunicar imediatamente quaisquer métricas. Se usar a consola do Gestor de servidores instalada no Windows Server, pode ver que o seu servidor tem o estado Online - Performance Counters not started (Online – Contadores de desempenho não iniciados) na coluna Manageability (Gerenciamento).

Uma forma de ativar o IIS para gerar métricas é clicar com o botão direito do rato no servidor IIS na consola do Gestor de servidores e selecionar Iniciar contadores de desempenho. O servidor deve começar a enviar métricas para o agente de operações.

Configure a recolha de métricas da versão 2

Para carregar métricas da versão 2 do IIS, tem de criar um recetor para as métricas que o IIS produz e, em seguida, criar um pipeline para o novo recetor.

Este recetor não suporta a utilização de várias instâncias na configuração, por exemplo, para monitorizar vários pontos finais. Todas essas instâncias escrevem na mesma série cronológica e o Cloud Monitoring não tem forma de as distinguir.

Para configurar um destinatário para as suas métricas iis, especifique os seguintes campos:

Campo	Predefinição	Descrição
`collection_interval`	60s	Um valor time.Duration, como 30s ou 5m.
`receiver_version`		Versão das métricas recolhidas; use `2` para recolher métricas da v2.
`type`		Este valor tem de ser `iis`.

Por predefinição, as métricas da v1 são recolhidas automaticamente. Pode aumentar as métricas v1 recolhendo também métricas v2 ou pode substituir as métricas v1 para recolher apenas métricas v2.

Para recolher apenas métricas da versão 2, faça o seguinte:
- Atribua um nome ao recetor iis.
- Defina o campo type como iis.
- Defina o campo receiver_version como 2.
- Use este recetor no seu pipeline default_pipeline. Esta configuração substitui a configuração integrada do recetor iis.
Para recolher métricas v1 e v2, faça o seguinte:
- Atribua ao recetor um nome diferente de iis, como iis_v2.
- Defina o campo type como iis.
- Definir o receiver_version para 2.
- Use este recetor no novo pipeline. Esta configuração adiciona um recetor v2 em vez de substituir o recetor incorporado. O script na Configuração de exemplo usa esta abordagem.

O que é monitorizado

A partir da versão 2.15.0, o agente de operações pode recolher dois conjuntos diferentes de métricas:

As métricas da v1: agent.googleapis.com/iis/.
As métricas da v2: workload.googleapis.com/.

Métricas V1

A tabela seguinte apresenta a lista de métricas da v1 que o agente de operações recolhe da instância do IIS.

As strings "metric type" nesta tabela têm de ter o prefixo agent.googleapis.com/iis/. Esse prefixo foi omitido das entradas na tabela. Ao consultar uma etiqueta, use o prefixo metric.labels.; por exemplo, metric.labels.LABEL="VALUE".

Tipo de métrica ^{Fase de lançamento} (Níveis da hierarquia de recursos) Nome a apresentar
Kind, Type, Unit Recursos monitorizados	Descrição Etiquetas
`current_connections` ^GA *(project)* IIS open connections
`GAUGE`, `DOUBLE`, `1` aws_ec2_instance gce_instance	Ligações atualmente abertas ao IIS. Amostrada a cada 60 segundos.
`network/transferred_bytes_count` ^GA *(project)* Bytes transferidos do IIS
`CUMULATIVE`, `INT64`, `By` aws_ec2_instance gce_instance	Bytes de rede transferidos pelo IIS. Amostrada a cada 60 segundos. `direction`: Direction (sent, received)
`new_connection_count` ^GA *(projeto)* Ligações IIS
`CUMULATIVE`, `INT64`, `1` aws_ec2_instance gce_instance	Ligações abertas ao IIS. Amostrada a cada 60 segundos.
`request_count` ^GA *(project)* Pedidos IIS
`CUMULATIVE`, `INT64`, `1` aws_ec2_instance gce_instance	Pedidos feitos ao IIS. Amostrada a cada 60 segundos. `http_method`: Método HTTP (post, put, get, delete, option, trace, head)

Tabela gerada a 12/09/2025 às 17:40:42 UTC.

Métricas da V2

A tabela seguinte apresenta a lista de métricas da versão 2 que o agente de operações recolhe da instância do IIS.

Tipo de métrica
Tipo, Tipo Recursos monitorizados	Etiquetas
`workload.googleapis.com/iis.connection.active`
`GAUGE`, `INT64` gce_instance
`workload.googleapis.com/iis.connection.anonymous`
`CUMULATIVE`, `INT64` gce_instance
`workload.googleapis.com/iis.connection.attempt.count`
`CUMULATIVE`, `INT64` gce_instance
`workload.googleapis.com/iis.network.blocked`
`CUMULATIVE`, `INT64` gce_instance
`workload.googleapis.com/iis.network.file.count`
`CUMULATIVE`, `INT64` gce_instance	`direction`
`workload.googleapis.com/iis.network.io`
`CUMULATIVE`, `INT64` gce_instance	`direction`
`workload.googleapis.com/iis.request.count`
`CUMULATIVE`, `INT64` gce_instance	`request`
`workload.googleapis.com/iis.request.queue.age.max`
`GAUGE`, `INT64` gce_instance
`workload.googleapis.com/iis.request.queue.count`
`GAUGE`, `INT64` gce_instance
`workload.googleapis.com/iis.request.rejected`
`CUMULATIVE`, `INT64` gce_instance
`workload.googleapis.com/iis.thread.active`
`GAUGE`, `INT64` gce_instance
`workload.googleapis.com/iis.uptime`
`GAUGE`, `INT64` gce_instance

Valide a configuração

Esta secção descreve como verificar se configurou corretamente o recetor do IIS. O agente de operações pode demorar um ou dois minutos a começar a recolher telemetria.

Para verificar se os registos do IIS estão a ser enviados para o Cloud Logging, faça o seguinte:

Na Google Cloud consola, aceda à página Explorador de registos:
Aceda ao Explorador de registos

Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cuja legenda é Registo.
Introduza a seguinte consulta no editor e, de seguida, clique em Executar consulta:
```
resource.type="gce_instance"
log_id("iis_access")
```

Para verificar se as métricas do IIS estão a ser enviadas para o Cloud Monitoring, faça o seguinte:

Na Google Cloud consola, aceda à página Explorador de métricas:
Aceda ao Metrics Explorer

Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cujo subtítulo é Monitorização.
Na barra de ferramentas do painel do criador de consultas, selecione o botão cujo nome é MQL ou PromQL.
Verifique se a opção PromQL está selecionada no botão Idioma. O botão para alternar o idioma encontra-se na mesma barra de ferramentas que lhe permite formatar a consulta.

Para métricas da v1, introduza a seguinte consulta no editor e, de seguida, clique em Executar consulta:
```
{"agent.googleapis.com/iis/request_count", monitored_resource="gce_instance"}
```
Para métricas da v2, introduza a seguinte consulta no editor e, de seguida, clique em Executar:
```
{"workload.googleapis.com/iis.request.count", monitored_resource="gce_instance"}
```

Ver o painel de controlo

Para ver as métricas do IIS, tem de ter um gráfico ou um painel de controlo configurado. A integração do IIS inclui um ou mais painéis de controlo para si. Todos os painéis de controlo são instalados automaticamente depois de configurar a integração e o agente de operações começar a recolher dados de métricas.

Também pode ver pré-visualizações estáticas de painéis de controlo sem instalar a integração.

Para ver um painel de controlo instalado, faça o seguinte:

Na Google Cloud consola, aceda à página Painéis de controlo:
Aceda a Painéis de controlo

Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cujo subtítulo é Monitorização.
Selecione o separador Lista de painéis de controlo e, de seguida, escolha a categoria Integrações.
Clique no nome do painel de controlo que quer ver.

Se configurou uma integração, mas o painel de controlo não foi instalado, verifique se o agente de operações está em execução. Quando não existem dados de métricas para um gráfico no painel de controlo, a instalação do painel de controlo falha. Depois de o agente de operações começar a recolher métricas, o painel de controlo é instalado para si.

Para ver uma pré-visualização estática do painel de controlo, faça o seguinte:

Na Google Cloud consola, aceda à página Integrações:
Aceda a Integrações

Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cujo subtítulo é Monitorização.
Clique no filtro da plataforma de implementação Compute Engine.
Localize a entrada para IIS e clique em Ver detalhes.
Selecione o separador Painéis de controlo para ver uma pré-visualização estática. Se o painel de controlo estiver instalado, pode navegar até ele clicando em Ver painel de controlo.

Para mais informações acerca dos painéis de controlo no Cloud Monitoring, consulte o artigo Painéis de controlo e gráficos.

Para mais informações sobre como usar a página Integrações, consulte o artigo Gerir integrações.

Instale políticas de alerta

As políticas de alerta indicam ao Cloud Monitoring que lhe envie uma notificação quando ocorrerem condições especificadas. A integração do IIS inclui uma ou mais políticas de alerta para sua utilização. Pode ver e instalar estas políticas de alerta na página Integrações em Monitorização.

Para ver as descrições das políticas de alerta disponíveis e instalá-las, faça o seguinte:

Na Google Cloud consola, aceda à página Integrações:
Aceda a Integrações

Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cujo subtítulo é Monitorização.
Localize a entrada para IIS e clique em Ver detalhes.
Selecione o separador Alertas. Este separador apresenta descrições das políticas de alerta disponíveis e uma interface para as instalar.
Instale políticas de alerta. As políticas de alerta precisam de saber para onde enviar notificações de que o alerta foi acionado, pelo que requerem informações suas para a instalação. Para instalar políticas de alerta, faça o seguinte:
1. Na lista de políticas de alerta disponíveis, selecione as que quer instalar.
2. Na secção Configurar notificações, selecione um ou mais canais de notificação. Tem a opção de desativar a utilização de canais de notificação, mas, se o fizer, as suas políticas de alerta são acionadas silenciosamente. Pode verificar o respetivo estado em Monitorização, mas não recebe notificações.
  
  Para mais informações sobre os canais de notificação, consulte o artigo Faça a gestão dos canais de notificação.
3. Clique em Criar políticas.

Para mais informações sobre as políticas de alerta no Cloud Monitoring, consulte o artigo Introdução aos alertas.