IIS

L'integrazione di Internet Information Services raccoglie la telemetria dai server web IIS. Le metriche forniscono informazioni sulla connessione e dati sui byte trasferiti. L'integrazione raccoglie anche le informazioni dai log di accesso.

Per ulteriori informazioni su IIS, consulta la documentazione dei servizi di informazioni su Internet.

Prima di iniziare

La versione 2.15.0 dell'agente Ops introduce il supporto per un nuovo set di metriche IIS utilizzando il prefisso workload.googleapis.com/. Devi configurare l'agente per raccogliere queste metriche, come descritto nella sezione Configurazione di esempio.

L'agente Ops ha sempre supportato un insieme limitato di metriche IIS, che utilizzano il prefisso agent.googleapis.com/iis/. Non sono necessarie configurazioni aggiuntive per raccogliere queste metriche sulle VM Windows.

Questo documento fa riferimento alle metriche con prefisso agent come metriche v1 e alle metriche con prefisso workload come v2. Per le tabelle di queste metriche, consulta la sezione Che cosa viene monitorato.

A partire dall'agente Ops alla versione 2.15.0, puoi configurare l'agente in modo da raccogliere le metriche v1, v2 o entrambe.

Nota: se hai creato avvisi o altre configurazioni basate sulle metriche v1 e passi alle metriche v2, devi eseguire anche la migrazione delle configurazioni. Se interrompi la raccolta delle metriche v1, gli avvisi e altre metriche di monitoraggio di queste metriche smetteranno di funzionare. La seguente tabella mostra la mappatura delle metriche v1 a quelle v2:

Metrica v1 (`agent.googleapis.com/iis/`)	Metrica 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`

Prerequisiti

Per raccogliere la telemetria di IIS, devi installare l'agente operativo:

Per le metriche v1, installa la versione 1.0.0 o successive.
Per le metriche v2, installa la versione 2.15.0 o successive
Per i log, installa la versione 2.14.0 o una versione successiva.

Questa integrazione supporta IIS versioni 8.5 e 10.0.

Configura l'agente Ops per IIS

Segui la guida per configurare l'agente Ops, aggiungere gli elementi richiesti per raccogliere la telemetria dalle istanze IIS e riavviare l'agente.

Configurazione di esempio

Il comando seguente crea la configurazione per raccogliere e importare la telemetria per IIS e riavvia l'agente operativo.

# 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 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
"

Stop-Service google-cloud-ops-agent -Force
Start-Service google-cloud-ops-agent*

Questo ricevitore supporta solo il formato di logging W3C predefinito.

Configura raccolta di log

Per importare i log degli accessi da IIS, devi creare destinatari per i log e creare una pipeline per i nuovi destinatari.

Per configurare un destinatario per i log iis_access, specifica i seguenti campi:

Campo	Predefinito	Descrizione
`exclude_paths`	`[]`	Un elenco di pattern di percorsi del file system da escludere dal set corrispondente a `include_paths`.
`include_paths`	`['C:\inetpub\logs\LogFiles\W3SVC1\u_ex*']`	Un elenco di percorsi del filesystem da leggere aggiungendo in coda ogni file. È possibile utilizzare un carattere jolly (``) nei percorsi, ad esempio `C:\inetpub\logs\LogFiles\W3SVC1\u_ex`.
`type`		Il valore deve essere `iis_access`.
`record_log_file_path`	`false`	Se è impostato su `true`, il percorso del file specifico da cui è stato ottenuto il record di log viene visualizzato nella voce di log di output come valore dell'etichetta `agent.googleapis.com/log_file_path`. Quando utilizzi un carattere jolly, viene registrato solo il percorso del file da cui è stato ottenuto il record.
`wildcard_refresh_interval`	`60s`	L'intervallo con cui vengono aggiornati i percorsi dei file con caratteri jolly in `include_paths`. Specificato come intervallo di tempo analizzabile da `time.ParseDuration`, ad esempio 30 s o 2 m. Questa proprietà potrebbe essere utile in velocità effettiva di logging elevata in cui i file di log vengono ruotati più velocemente dell'intervallo predefinito.

Cosa viene registrato

logName viene ricavato dagli ID ricevitore specificati nella configurazione. I campi dettagliati all'interno di LogEntry sono i seguenti.

I log iis_access contengono i seguenti campi in LogEntry:

Campo	Tipo	Descrizione
`httpRequest.referer`	string	Contenuti dell'intestazione `Referer`
`httpRequest.remoteIp`	string	IP del client che ha effettuato la richiesta
`httpRequest.requestMethod`	string	Metodo HTTP
`httpRequest.requestUrl`	string	URL di richiesta (in genere soltanto la parte del percorso dell'URL)
`httpRequest.serverIp`	string	L'IP e la porta del server richiesti
`httpRequest.status`	number	Codice di stato HTTP
`httpRequest.userAgent`	string	Contenuti dell'intestazione `User-Agent`
`jsonPayload.sc_substatus`	number	Il codice di errore dello stato secondario
`jsonPayload.sc_win32_status`	number	Il codice di stato di Windows
`jsonPayload.time_taken`	number	Il tempo, in millisecondi, che l'azione è stata eseguita.
`jsonPayload.user`	string	Nome utente autenticato per la richiesta
`timestamp`	stringa (`Timestamp`)	Ora in cui è stata ricevuta la richiesta.

Configura la raccolta delle metriche v1

L'agente operativo su una VM Microsoft Windows raccoglie automaticamente le metriche IIS v1. Non sono richieste configurazioni aggiuntive. Per informazioni sulla raccolta solo delle metriche v2, consulta Configurare la raccolta delle metriche v2.

Dopo aver configurato una nuova istanza di IIS, IIS potrebbe non segnalare immediatamente alcuna metrica. Utilizzando la console di Server Manager installata su Windows Server, potresti notare che lo stato del server è Online - Performance Counters not start nella colonna Gestione.

Un modo per abilitare IIS per generare metriche è fare clic con il tasto destro del mouse sul server IIS nella console di Server Manager e selezionare Avvia contatori delle prestazioni. Il tuo server dovrebbe iniziare a inviare metriche all'agente operativo.

Configura la raccolta delle metriche v2

Per importare le metriche v2 da IIS, devi creare un ricevitore per le metriche generate da IIS e creare una pipeline per il nuovo destinatario.

Questo ricevitore non supporta l'uso di più istanze nella configurazione, ad esempio per monitorare più endpoint. Tutte queste istanze scrivono nella stessa serie temporale e Cloud Monitoring non ha modo di distinguerle.

Per configurare un destinatario per le metriche iis, specifica i seguenti campi:

Campo	Predefinito	Descrizione
`collection_interval`	60 secondi	Un valore time.Duration, ad esempio 30 s o 5 m.
`receiver_version`		Versione delle metriche raccolte; utilizza `2` per raccogliere metriche v2.
`type`		Questo valore deve essere `iis`.

Per impostazione predefinita, le metriche v1 vengono raccolte automaticamente. Puoi aumentare le metriche v1 raccogliendo ulteriormente le metriche v2 oppure puoi sostituire le metriche v1 per raccogliere solo le metriche v2.

Per raccogliere solo le metriche v2, procedi nel seguente modo:
- Assegna al destinatario il nome iis.
- Imposta il campo type su iis.
- Imposta il campo receiver_version su 2.
- Usa questo ricevitore nella tua pipeline default_pipeline. Questa configurazione sostituisce la configurazione integrata del ricevitore iis.
Per raccogliere le metriche v1 e v2, procedi nel seguente modo:
- Assegna al destinatario un nome diverso da iis, ad esempio iis_v2.
- Imposta il campo type su iis.
- Imposta receiver_version su 2.
- Usa questo ricevitore nella nuova pipeline. Questa configurazione aggiunge un ricevitore v2 anziché sostituire il ricevitore integrato. Lo script nella configurazione di esempio utilizza questo approccio.

Che cosa viene monitorato

A partire dalla versione 2.15.0, l'agente Ops può raccogliere due diversi insiemi di metriche:

Le metriche v1: agent.googleapis.com/iis/.
Le metriche v2: workload.googleapis.com/.

Metriche V1

La seguente tabella fornisce l'elenco delle metriche v1 che l'agente operativo raccoglie dall'istanza IIS.

Le stringhe di "tipo di metrica" in questa tabella devono essere precedute da agent.googleapis.com/iis/. Il prefisso è stato omesso dalle voci della tabella.

Tipo di metrica ^{Fase di lancio} Nome visualizzato
Tipo, tipo, unità Risorse monitorate	Descrizione Etichette
`current_connections` ^GA Connessioni aperte di IIS
`GAUGE`, `DOUBLE`, `1` aws_ec2_instance, gce_instance	Connessioni attualmente aperte a IIS. Campionata ogni 60 secondi.
`network/transferred_bytes_count` ^GA IIS ha trasferito i byte
`CUMULATIVE`, `INT64`, `By` aws_ec2_instance, gce_instance	Byte di rete trasferiti da IIS. Campionata ogni 60 secondi. `direction`: Indicazioni stradali (inviate, ricevute)
`new_connection_count` ^GA Connessioni IIS
`CUMULATIVE`, `INT64`, `1` aws_ec2_instance, gce_instance	Connessioni aperte a IIS. Campionata ogni 60 secondi.
`request_count` ^GA Richieste IIS
`CUMULATIVE`, `INT64`, `1` aws_ec2_instance, gce_instance	Richieste effettuate a IIS. Campionata ogni 60 secondi. `http_method`: Metodo HTTP (post, mettere, ottieni, elimina, opzione, traccia, testa)

Tabella generata il 30-03-2023 alle 20:53:06 UTC.

Metriche V2

La seguente tabella fornisce l'elenco delle metriche v2 che l'agente Ops raccoglie dall'istanza IIS.

Tipo di metrica
Tipo, tipo Risorse monitorate	Etichette
`workload.googleapis.com/iis.request.count`
`CUMULATIVE`, `INT64` gce_instance	`request`
`workload.googleapis.com/iis.request.rejected`
`CUMULATIVE`, `INT64` gce_instance
`workload.googleapis.com/iis.request.queue.count`
`GAUGE`, `INT64` gce_instance
`workload.googleapis.com/iis.request.queue.age.max`
`GAUGE`, `INT64` gce_instance
`workload.googleapis.com/iis.network.file.count`
`CUMULATIVE`, `INT64` gce_instance	`direction`
`workload.googleapis.com/iis.network.blocked`
`CUMULATIVE`, `INT64` gce_instance
`workload.googleapis.com/iis.network.io`
`CUMULATIVE`, `INT64` gce_instance	`direction`
`workload.googleapis.com/iis.connection.attempt.count`
`CUMULATIVE`, `INT64` gce_instance
`workload.googleapis.com/iis.connection.active`
`GAUGE`, `INT64` gce_instance
`workload.googleapis.com/iis.connection.anonymous`
`CUMULATIVE`, `INT64` gce_instance
`workload.googleapis.com/iis.thread.active`
`GAUGE`, `INT64` gce_instance
`workload.googleapis.com/iis.uptime`
`GAUGE`, `INT64` gce_instance

Verificare la configurazione

Questa sezione descrive come verificare che tu abbia configurato correttamente il ricevitore IIS. L'agente Ops potrebbe richiedere uno o due minuti per iniziare a raccogliere la telemetria.

Per verificare che i log siano importati, vai a Esplora log ed esegui la query seguente per visualizzare i log IIS:

resource.type="gce_instance"
logName=("projects/PROJECT_ID/logs/iis_access")

Per verificare che le metriche siano importate, vai a Metrics Explorer ed esegui una delle seguenti query nella scheda MQL.

Per le metriche v1:

fetch gce_instance
| metric 'agent.googleapis.com/iis/request_count'
| every 1m

Per le metriche v2:

fetch gce_instance
| metric 'workload.googleapis.com/iis.request.count'
| every 1m

Visualizza dashboard

Per visualizzare le metriche IIS, devi configurare un grafico o una dashboard. L'integrazione di IIS include una o più dashboard. Le dashboard vengono installate automaticamente dopo la configurazione dell'integrazione e l'Ops Agent inizia a raccogliere i dati delle metriche.

Puoi anche visualizzare le anteprime statiche delle dashboard senza installare l'integrazione.

Per visualizzare una dashboard installata, procedi come segue:

Nella console Google Cloud, seleziona Monitoring o fai clic sul pulsante seguente:
Vai a Monitoring
Nel pannello di navigazione, seleziona Dashboard.
Seleziona la scheda Elenco dashboard.
Scegli la categoria Integrazioni.
Fai clic sul nome della dashboard che vuoi visualizzare.

Se hai configurato un'integrazione ma la dashboard non è stata installata, verifica che l'agente Ops sia in esecuzione. Se la dashboard non contiene dati sulle metriche, l'installazione della dashboard ha esito negativo. Quando l'agente Ops inizia a raccogliere le metriche, la dashboard viene installata automaticamente.

Per visualizzare un'anteprima statica della dashboard:

Nella console Google Cloud, seleziona Monitoring o fai clic sul pulsante seguente:
Vai a Monitoring
Nel riquadro di navigazione, seleziona Integrazioni.
Fai clic sul filtro della piattaforma di deployment di Compute Engine.
Individua la voce per IIS e fai clic su Visualizza dettagli.
Seleziona la scheda Dashboard per visualizzare un'anteprima statica. Se la dashboard è installata, puoi accedervi facendo clic su Visualizza dashboard.

Per ulteriori informazioni sulle dashboard in Cloud Monitoring, consulta Dashboard e grafici.

Per ulteriori informazioni sull'utilizzo della pagina Integrazioni, consulta Gestire le integrazioni.

Installa criteri di avviso

I criteri di avviso indicano a Cloud Monitoring di avvisarti quando si verificano condizioni specificate. L'integrazione di IIS include uno o più criteri di avviso che puoi utilizzare. Puoi visualizzare e installare questi criteri di avviso dalla pagina Integrazioni in Monitoring.

Per visualizzare le descrizioni dei criteri di avviso disponibili e installarli, procedi nel seguente modo:

Nella console Google Cloud, seleziona Monitoring o fai clic sul pulsante seguente:
Vai a Monitoring
Nel riquadro di navigazione, seleziona Integrazioni.
Individua la voce IIS e fai clic su Visualizza dettagli.
Seleziona la scheda Avvisi. Questa scheda fornisce le descrizioni dei criteri di avviso disponibili e un'interfaccia per l'installazione.
Installa i criteri di avviso. I criteri di avviso devono sapere dove inviare le notifiche che attivano l'avviso, pertanto richiedono informazioni da installare per l'installazione. Per installare i criteri di avviso:
1. Seleziona dall'elenco dei criteri di avviso disponibili quelli che vuoi installare.
2. Nella sezione Configura le notifiche, seleziona uno o più canali di notifica. Hai la possibilità di disabilitare l'utilizzo dei canali di notifica, ma se lo fai, i tuoi criteri di avviso verranno attivati in silenzio. Puoi verificarne lo stato in Monitoring, ma non riceverai notifiche.
  
  Per maggiori informazioni sui canali di notifica, consulta Gestire i canali di notifica.
3. Fai clic su Crea criteri.

Per ulteriori informazioni sui criteri di avviso in Cloud Monitoring, consulta Introduzione agli avvisi.

Per ulteriori informazioni sull'utilizzo della pagina Integrazioni, consulta Gestire le integrazioni.

Passaggi successivi

Per una procedura dettagliata su come utilizzare Ansible per installare l'agente Ops, configurare un'applicazione di terze parti e installare una dashboard di esempio, guarda il video Installare l'agente Ops per risolvere i problemi delle applicazioni di terze parti.