Microsoft IIS unter Windows Server 2000 oder höher

Anleitung zum Installieren und Konfigurieren von Sensor für Internet Information Services (IIS) 5.x oder 6.x unter Microsoft Windows Server 2000 oder höher.

Bei Verwendung von IIS 6.x muss die Protokollierung aktiviert sein, damit Sensor ordnungsgemäß funktioniert. Wenn Sie die Protokollierung deaktiviert haben, um die Datenträger-E/A zu reduzieren, können Sie die Protokollierung aktivieren, ohne Daten in die Protokolle schreiben zu müssen. Aktivieren Sie dazu die Protokollierung und löschen Sie dann alle Felder auf der Registerkarte Erweitert der Eigenschaften für das W3C Extended Log File Format. Wenden Sie sich bei Bedarf an Adobe Consulting Services.

Die Programmdateien für Sensor werden in einer Installationsdatei zusammengefasst, die Sie von der Adobe-Download-Site erhalten. Wenn Sie noch nicht über die Installationsdatei für den Sensor für Ihren Webserver verfügen, laden Sie sie herunter (oder rufen Sie sie von Ihrem Kundenbetreuer ab), bevor Sie mit den folgenden Verfahren beginnen.

Um Sensor zu installieren und zu konfigurieren, müssen Sie die folgenden allgemeinen Schritte ausführen:

1. Installieren Sie die Programmdateien

Beim Ausführen von Sensor unter Windows IIS müssen sich die Programmdateien und die Datei mit der Festplattenwarteschlange im selben Ordner befinden.

Daher müssen Sie vor der Installation der Programmdateien bestimmen, wo Sie die Festplattenwarteschlange warten möchten, da dort auch die Programmdateien installiert werden müssen.

Gehen Sie wie folgt vor, um die Programmdateien für Sensor zu extrahieren und zu installieren.

  1. Erstellen Sie auf Ihrem Windows-Computer einen Ordner, in dem Sie die Programmdateien des Sensor installieren können. Beachten Sie, dass sich Ihre Datenträgerwarteschlange auch in diesem Verzeichnis befindet. Stellen Sie daher sicher, dass das gewählte Gerät über ausreichend Speicherplatz verfügt, um eine Warteschlange mit der benötigten Größe zu speichern.

    Beispiel: C:\VisualSensor

  2. Extrahieren Sie den Inhalt der Installationsdatei in das soeben erstellte Verzeichnis. Während dieses Schritts installiert Sensor die folgenden Dateien:

Datei Beschreibung
EventMessages.dll Ereignis-Viewer-Nachrichten.
qlog.dll Das Sammlermodul (ein ISAPI-Filter).
TestExperiment.xls

Eine Excel-Tabellenkalkulationsdatei, mit der Architekten ein gesteuertes Experiment konfigurieren können.

Sensor verwendet diese Datei nicht.

trust_ca_cert.pem Das Zertifikat, das zum Überprüfen des digitalen Zertifikats verwendet wird, das Insight Server während des Verbindungsprozesses präsentiert.
TXLog.exe Das Transmitter-Programm.
txlogd.conf Die Konfigurationsdatei für Sensor.
HINWEIS

Das Installationspaket enthält eine Tabellendatei mit dem Namen TestExperiment.xls. Diese Tabelle ist ein Tool, mit dem Architekten ein gesteuertes Experiment konfigurieren. Sensor selbst verwendet diese Datei nicht, daher ist es nicht notwendig, die Datei auf dem Computer zu installieren, auf dem Sensor ausgeführt wird (obwohl Sie dies tun können). Sie können die Datei stattdessen an einen Speicherort kopieren, an dem Ihre Architekten darauf zugreifen können, oder einfach die Datei aus dem Installationspaket extrahieren. Weitere Informationen zu kontrollierten Experimenten finden Sie im Leitfaden zu kontrollierten Experimenten mit Insight.

2. Bearbeiten Sie die Konfigurationsdatei

Die Datei txlogd.conf enthält die Konfigurationsparameter für Sensor.

Sie müssen die Datei bearbeiten, um unter anderem die Größe der Festplattenwarteschlange, die Adresse des Insight Servers und die Kennung anzugeben, die an die von diesem Sensor erzeugten Daten angehängt werden soll. Die Konfigurationsdatei enthält die erforderlichen Parameter und optionalen Parameter.

  • Erforderliche Parameter sind Einstellungen, die Sie bei der Installation von Sensor angeben müssen. Ohne diese Einstellungen wird Sensor nicht erfolgreich ausgeführt.
  • Optionale Parameter sind Einstellungen, die standardmäßig vordefinierte Werte enthalten (die Sie ändern können) oder optionale Funktionen aktivieren.

Bearbeiten der Sensorkonfigurationsdatei

  1. Öffnen Sie die Datei <SensorDirectory>/txlogd.conf in einem Texteditor und legen Sie die erforderlichen Parameter sowie die gewünschten optionalen Parameter fest.

    Beschreibungen der Parameter txlogd.conf finden Sie unter Parameter für die Datei Sensor-Txlogd.conf .

    Beispiele für abgeschlossene Konfigurationsdateien finden Sie unter Konfigurationsdateien für Sensor-Beispiele .

  2. Speichern und schließen Sie die Datei.

3. Starten Sie den Transmitter und erstellen Sie die Festplattenwarteschlange.

Nachdem Sie die Datei txlogd.conf konfiguriert haben, können Sie das Transmitter-Programm starten, sie als Windows-Dienst registrieren und die Disk-Warteschlange erstellen.

  1. Wählen Sie unter Windows im Menü Start die Option Zubehör > Eingabeaufforderung aus.

  2. Navigieren Sie im Eingabeaufforderungsfenster zum Ordner, in dem Sie Sensor installiert haben, und führen Sie den folgenden Befehl aus:

    txlog /regserver
    

    Dieser Befehl startet den Transmitter, erstellt die Festplattenwarteschlange und registriert Sensor als Windows-Dienst.

  3. Um sicherzustellen, dass der Transmitter ordnungsgemäß ausgeführt wird, klicken Sie auf Start > Systemsteuerung > Verwaltung > Dienste.

    HINWEIS

    Diese Befehlssequenz variiert je nach verwendeter Windows-Version.

    1. Suchen Sie in der Dienstliste den Eintrag für Sensor und bestätigen Sie, dass sein Status Gestartet und sein Starttyp Automatisch lautet.
    2. Schließen Sie die Systemsteuerung "Dienste".
  4. Um zu überprüfen, ob Transmitter beim Start Fehler erhalten hat, klicken Sie auf Start > Systemsteuerung > Verwaltung > Ereignis-Viewer , um die Ereignisanzeige zu öffnen.

    HINWEIS

    Diese Befehlssequenz variiert je nach verwendeter Windows-Version.

    1. Wählen Sie im linken Bereich des Fensters Ereignis-Viewer das Protokoll Anwendungen aus.
    2. Suchen Sie im rechten Bereich nach Ereignissen mit "Adobe"in der Quellspalte.
    3. Doppelklicken Sie auf die Fehlermeldung "Adobe", um das Fenster Ereigniseigenschaften anzuzeigen. In diesem Fenster erhalten Sie detaillierte Informationen zum Fehler.
  5. Wenn Sie die Prüfung des Anwendungsprotokolls abgeschlossen haben, schließen Sie die Ereignisanzeige.

  6. Stellen Sie sicher, dass der Transmitter die Festplattenwarteschlange (Diskq2000.log) in dem Verzeichnis erstellt hat, in dem Sie die Dateien des Sensor-Programms installiert haben, und dass es sich um die Größe handelt, die Sie im Parameter QueueSize in der Datei txlogd.conf angegeben haben.

    Wenn die Warteschlange nicht korrekt erstellt wurde:

    1. Überprüfen Sie die Datei txtlogd.conf und überprüfen Sie, ob der Parameter QueueSize richtig eingestellt ist.

    2. Vergewissern Sie sich, dass auf dem Gerät, auf dem Sie Sensor installiert haben, ausreichend Speicherplatz für eine Datei zur Verfügung steht, die der im Parameter QueueSize angegebenen Größe entspricht.

    3. Beenden Sie den Transmitter über das Bedienfeld Dienste in Windows.

    4. Löschen Sie die Warteschlangendatei.

    5. Registrieren Sie Sensor als Windows-Dienst erneut: Wählen Sie unter Windows im Menü Start die Option Zubehör > Eingabeaufforderung aus. Navigieren Sie im Eingabeaufforderungsfenster zum Ordner, in dem Sie Sensor installiert haben, und führen Sie den folgenden Befehl aus:

      txlog /regserver
      

Der Transmitter ist für eine kontinuierliche Ausführung ausgelegt. Wenn Sie den Computer neu starten, wird der Transmitter automatisch neu gestartet. Wenn Sie den Transmitter manuell starten und anhalten müssen, können Sie dies über die Systemsteuerung Dienste in Windows tun.

Hinzufügen des Sammlers zum Webserver

Bei IIS ist der Wächter ein ISAPI-Filter, den Sie Ihrem Webserver in IIS hinzufügen.

  1. Öffnen Sie den IIS-Manager mithilfe des Managers Start > Verwaltung > Internetinformationsdienste (IIS).

  2. Erweitern Sie die Knoten Lokaler Computer und Websites .

  3. Klicken Sie mit der rechten Maustaste auf die Website, der Sie den Kollektor hinzufügen möchten, und wählen Sie Eigenschaften aus.

  4. Wählen Sie die Registerkarte ISAPI-Filter und klicken Sie auf Hinzufügen.

  5. Geben Sie im Feld Filtername einen Anzeigenamen für den Filter ein. Der vorgeschlagene Filtername lautet "Sensor".

  6. Klicken Sie auf "Durchsuchen", wählen Sie die Datei "qlog.dll"(in dem Ordner, in dem Sie Sensor installiert haben) und klicken Sie auf "OK".

  7. Klicken Sie auf OK , um den Filter hinzuzufügen.

    Nach dem Hinzufügen des Filters ist der Kollektor sofort einsatzbereit und kann Daten erfassen. In der Spalte Status auf der Registerkarte ISAPI-Filter des IIS-Managers sollte ein nach oben grüner Pfeil angezeigt werden. Möglicherweise wird der grüne Pfeil erst angezeigt, wenn der Traffic tatsächlich durch den Filter fließt. In diesem Fall müssen Sie eine Anfrage an den Webserver senden, um zu bestätigen, dass der Wächter ordnungsgemäß funktioniert.

Wenn der grüne Pfeil nach dem Traffic zum Kollektor nicht angezeigt wird, führen Sie die folgenden Schritte aus:

  1. Klicken Sie auf Start > Verwaltung > Ereignis-Viewer , um die Ereignisanzeige auf Fehler zu überprüfen.

    HINWEIS

    Diese Befehlssequenz variiert je nach verwendeter Windows-Version.

  2. Wählen Sie im linken Bereich des Fensters Event Viewer das Anwendungsprotokoll aus.

  3. Suchen Sie im rechten Bereich nach Ereignissen mit "Adobe"in der Quellspalte.

  4. Wenn ein Fehler auftritt, doppelklicken Sie auf den Fehler, um das Fenster Ereigniseigenschaften anzuzeigen.

Erfassen zusätzlicher Daten

Webseiten werden häufig mithilfe der Programmiersprache ASP (Active Server Pages) strukturiert.

ASP ist eine Microsoft-Technologie, die innerhalb von IIS ausgeführt wird. Wenn ein Browser eine ASP-Datei anfordert, übergibt IIS die Anforderung an die ASP-Engine. Die ASP-Engine liest die ASP-Datei zeilenweise und führt die Skripte in der Datei aus. Schließlich wird die ASP-Datei als einfache HTML an den Browser zurückgegeben. ASP stellt RESPOND- oder REQUEST-Objekte bereit, die zusätzlich zu anderen Verwendungen die Antwort oder Anforderung von Benutzerabfragen oder Daten erlauben, die von HTML-Formularen gesendet werden.

In bestimmten Fällen möchten Sie die in Formularen eingegebenen Werte nicht an die URL anhängen, die in der Adressleiste des Browsers eines Benutzers angezeigt wird oder die im HTML-Code selbst sichtbar ist. Mit einfachem serverseitigem ASP-Skript können Sie Formularfeldnamen und die entsprechenden Werte an die Protokolldatei anhängen, ohne sie im Browser des Benutzers verfügbar zu machen oder in die HTML-Datei einzubetten. Um die tatsächlichen Formularwerte zu erfassen, die in bestimmte Formulare auf Ihrer Website eingegeben wurden, müssen einige Codezeilen hinzugefügt werden, um die Formularwerte an die Protokollanforderung anzuhängen.

Fügen Sie auf der Verarbeitungsseite eines Formulars den folgenden Code hinzu, um die eingegebenen Formularwerte an die Anfragedaten anzuhängen (zusätzlich zum Schreiben der gesendeten Formularwerte in eine externe Datenbank oder an einen anderen Speicherort):

var sName= Request.Form("Name");
var sCity= Request.Form("City");
var sState= Request.Form("State");
var sZip= Request.Form("Zip");

Response.AppendToLog("&v_1=" +  sName);
Response.AppendToLog("&v_2=" +  sCity);
Response.AppendToLog("&v_3=" +  sState);
Response.AppendToLog("&v_4=" +  sZip);

Durch diesen Prozess werden die Formularwerte, wie sie definiert sind, an die Anforderungsdaten für die Formularverarbeitungsseite angehängt. Innerhalb der Protokolldaten sind die angehängten Werte als Abfragezeichenfolgen der Formularverarbeitungsseite verfügbar, wie unten dargestellt. Beispielsweise wären v_1, v_2, v_3 und v_4 jetzt Abfragezeichenfolgen, die die in die entsprechenden Formularfelder eingegebenen Daten enthalten. Die im vorherigen Beispiel beschriebene Syntax kann für alle zusätzlichen Formularfelder und Werte dupliziert werden, die erfasst werden sollen:

https://www.myserver.com/path/to/formprocessingpage.asp?v_1=John+Smith&v_2=Los+Angeles&v_3=California&v_4=90210

Wenn Sie möchten, dass jedes Formularfeld und jeder Wert erfasst und für die Analyse verfügbar ist, können Sie die folgende Syntax verwenden:

var formvalues = Response.Form;
Response.AppendToLog(formvalues);

In diesem Beispiel werden alle in der HTML vorhandenen Formularfelder zusammen mit den entsprechenden Werten als Abfragezeichenfolgen an den Protokolleintrag für die Formularverarbeitungsseite angehängt. Bitte beachten Sie, dass dies alle verborgenen Felder im Formular einschließen würde.

Die Protokolldaten werden wie in der folgenden Tabelle beschrieben erweitert:

Erfasste Daten Erklärung Beispiel
v_1 Wert, der mit der Abfragezeichenfolge NAME verknüpft ist v_1=John Smith
v_2 Der CITY-Abfragezeichenfolge zugeordnete Wert v_2=Los Angeles
v_3 Wert, der mit der STATE-Abfragezeichenfolge verknüpft ist v_3=California
v_4 Der ZIP-Abfragezeichenfolge zugeordnete Wert v_4=90210

Auf dieser Seite