Textprotokolle in Amazon CloudWatch Logs anzeigen - Amazon Lex V1

Wenn Sie Amazon Lex V2 verwenden, lesen Sie stattdessen das Amazon Lex V2-Handbuch.

 

Wenn Sie Amazon Lex V1 verwenden, empfehlen wir, Ihre Bots auf Amazon Lex V2 zu aktualisieren. Wir fügen V1 keine neuen Funktionen mehr hinzu und empfehlen dringend, V2 für alle neuen Bots zu verwenden.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Textprotokolle in Amazon CloudWatch Logs anzeigen

Amazon Lex speichert Textprotokolle für Ihre Konversationen in Amazon CloudWatch Logs. Um die Protokolle anzuzeigen, können Sie die CloudWatch Logs-Konsole oder die API verwenden. Weitere Informationen finden Sie unter Durchsuchen von Protokolldaten mithilfe von Filtermustern und CloudWatch Logs Insights-Abfragesyntax im Amazon CloudWatch Logs-Benutzerhandbuch.

Amazon Lex

  1. Öffnen Sie die Amazon Lex Lex-Konsole https://console.aws.amazon.com/lex.

  2. Wählen Sie aus der Liste einen Bot aus.

  3. Wählen Sie die Registerkarte Settings (Einstellungen) und dann im linken Menü Conversation logs (Konversationsprotokolle).

  4. Wählen Sie den Link unter Textprotokolle, um die Protokolle für den Alias in der CloudWatch Konsole anzuzeigen.

Sie können auch die CloudWatch Konsole oder die API verwenden, um Ihre Protokolleinträge einzusehen. Um die Protokolleinträge zu suchen, navigieren Sie zu der Protokollgruppe, die Sie für den Alias konfiguriert haben. Sie finden das Log-Stream-Präfix für Ihre Protokolle in der Amazon Lex Lex-Konsole oder mithilfe desGetBotAlias Vorgangs.

Protokolleinträge für eine Benutzeräußerungen befinden sich in mehreren Protokolldatenstreams. Eine Äußerung in der Konversation hat einen Eintrag in einem der Protokolldatenstreams mit dem angegebenen Präfix. Ein Eintrag im Protokolldatenstream enthält die folgenden Informationen.

{
   "messageVersion": "1.0",
   "botName": "bot name",
   "botAlias": "bot alias",
   "botVersion": "bot version",
   "inputTranscript": "text used to process the request",
   "botResponse": "response from the bot",
   "intent": "matched intent",
   "nluIntentConfidence": "number",
   "slots": {
       "slot name": "slot value",
       "slot name": null,
       "slot name": "slot value"
       ...
   },
   "alternativeIntents": [
       {
           "name": "intent name",
           "nluIntentConfidence": "number",
           "slots": {
               "slot name": slot value,
               "slot name": null,
               "slot name": slot value
               ...
           }
       },
       {
           "name": "intent name",
           "nluIntentConfidence": number,
           "slots": {}
       }
   ],
   "developerOverride": "true" | "false",
   "missedUtterance": true | false,
   "inputDialogMode": "Text" | "Speech",
   "requestId": "request ID",
   "s3PathForAudio": "S3 path to audio file",
   "userId": "user ID",
   "sessionId": "session ID",
   "sentimentResponse": {
       "sentimentScore": "{Positive: number, Negative: number, Neutral: number, Mixed: number}",
       "sentimentLabel": "Positive" | "Negative" | "Neutral" | "Mixed"
   },
   "slotToElicit": "slot name",
   "dialogState": "ElicitIntent" | "ConfirmIntent" | "ElicitSlot" | "Fulfilled" | "ReadyForFulfillment" | "Failed",
   "responseCard": {
       "genericAttachments": [
           ...
       ],
       "contentType": "application/vnd.amazonaws.card.generic",
       "version": 1
    },
   "locale": "locale",
   "timestamp": "ISO 8601 UTC timestamp",
   "kendraResponse": {
      "totalNumberOfResults": number,
      "resultItems": [
          {
              "id": "query ID",
              "type": "DOCUMENT" | "QUESTION_ANSWER" | "ANSWER",
              "additionalAttributes": [
                  {
                     ...
                  }
              ],
              "documentId": "document ID",
              "documentTitle": {
                  "text": "title",
                  "highlights": null
              },
              "documentExcerpt": {
                  "text": "text",
                  "highlights": [
                      {
                          "beginOffset": number,
                          "endOffset": number,
                          "topAnswer": true | false
                      }
                  ]
              },
              "documentURI": "URI",
              "documentAttributes": []
          }  
      ],
      "facetResults": [],
      "sdkResponseMetadata": {
          "requestId": "request ID"
      },
      "sdkHttpMetadata": {
          "httpHeaders": {
              "Content-Length": "number",
              "Content-Type": "application/x-amz-json-1.1",
              "Date": "date and time",
              "x-amzn-RequestId": "request ID"
          },
          "httpStatusCode": 200
      },
      "queryId": "query ID"
   },
   "sessionAttributes": {
       "attribute name": "attribute value"
       ...
    },
   "requestAttributes": {
       "attribute name": "attribute value"
       ...
    }
}

Der Inhalt des Protokolleintrags hängt vom Ergebnis einer Transaktion und der Konfiguration des Bots und der Anfrage ab.

  • Die Felder intent, slots und slotToElicit werden nicht in einem Eintrag angezeigt, wenn das missedUtterance-Feld den Wert true hat.

  • Das s3PathForAudio-Feld wird nicht angezeigt, wenn Audioprotokolle deaktiviert sind oder wenn das inputDialogMode-Feld Text ist.

  • Das responseCard-Feld wird nur angezeigt, wenn Sie eine Antwortkarte für den Bot definiert haben.

  • Die requestAttributes-Karte wird nur angezeigt, wenn Sie in der Anforderung Anforderungsattribute angegeben haben.

  • DaskendraResponse Feld ist nur vorhanden, wenn er eine Anfrage zur Suche in einem Amazon Kendra Kendra-IndexAMAZON.KendraSearchIntent stellt.

  • DasdeveloperOverride Feld ist wahr, wenn in der Lambda-Funktion des Bots eine alternative Absicht angegeben wurde.

  • Die sessionAttributes-Karte wird nur angezeigt, wenn Sie Sitzungsattribute in der Anforderung angegeben haben.

  • Die sentimentResponse-Karte wird nur angezeigt, wenn Sie den Bot so konfigurieren, dass er Stimmungswerte zurückgibt.

Anmerkung

Das Eingabeformat kann sich auch ohne entsprechende Änderung der messageVersion ändern. Ihr Code sollte keinen Fehler ausgeben, wenn neue Felder vorhanden sind.

Sie müssen über eine Rolle und eine Richtlinie verfügen, damit Amazon Lex in CloudWatch Logs schreiben kann. Weitere Informationen finden Sie unter IAM-Richtlinien für Konversationsprotokolle.