SendGrid logs

The SendGrid log list allows you to view your SendGrid logs.

Accessing the screen

In the left sidebar menu, select [Operation] -> [Log management].

Image from Gyazo

Click [Log management] above the page title, and select [SendGrid logs] in the dropdown menu.

Image from Gyazo

Field descriptions

Image from Gyazo

Filter conditions

You can filter the JavaScript logs with a simple e-mail search or using advanced search conditions.

Enter the target e-mail address in the search box. You can use partial matches to narrow down the list of matching logs.

Image from Gyazo

Click the [Advanced search] button to input advanced filter conditions.

Image from Gyazo

The following input options are available:

FieldDescriptionSpecifiable conditions
Timestamp      Date and time the log was recorded.Date and time range specification
Event type        Event type.Event specification
RecipientE-mail address of the recipient.Available search operations
Notification IDMessage ID in Kuroco.Available search operations
Notification message IDSent message ID in Kuroco.Available search operations

The advanced search function allows you to concatenate multiple conditions using AND or OR.

  • AND: Returns only data matching all the specified conditions in your search.
  • OR: Returns data matching any of your specified conditions.
Date and time range specification

The following date and time input options are available:

  • Date range
  • Relative
  • Time range
  • Datetime range
Event specification

The following event input options are available:

  • Processed
  • Dropped
  • Delivered
  • Deferred
  • Bounce
  • Open
  • Click
  • Spam report
  • Unsubscribe
  • Group unsubscribe
Available search operations

You can specify the following operations in the search conditions:

OperationInput typeReturned data
containsText stringEntries matching part of the search term.
not containsText stringEntries not matching any part of the search term.
=Alphanumeric stringEntries exactly matching the search term.
!=Alphanumeric stringEntries not exactly matching the search term.
<Alphanumeric stringEntries less than the search term.
>Alphanumeric stringEntries greater than the search term.
<=Alphanumeric stringEntries less than or equal to the search term.
>=Alphanumeric stringEntries greater than or equal to the search term.
starts withText stringEntries beginning with the search term.
not starts withText stringEntries not beginning with the search term.
ends withText stringEntries ending with the search term.
not ends withText stringEntries not ending with the search term.
inAlphanumeric stringEntries matching any of the search terms (for multiple search terms only).
not inAlphanumeric stringEntries not matching any of the search terms (for multiple search terms only).
Sort

Under "Sort", you can specify the sort key and display order of the search results.

  • ASC: Ascending, from oldest to newest.
  • DESC: Descending, from newest to oldest.

Log entries

The columns displayed for the log entries are as follows:

ColumnDescription
Timestamp Date and time the log was recorded.
Event typeEvent type.
RecipientE-mail address of the recipient.
Message IDMessage ID in SendGrid.
Client IP address IP address of the user who attempted the access.
User agent User agent of the browser used for the access.
Open event generated(Apple Mail Privacy Protection)Apple's Mail Privacy Protection feature, shown as true or false here.
  • If true, the opened/read status of the message will be unknown.
URLAccessed URL links.
URL offsetNumbering for links to the same URL in the e-mail.
Notification IDMessage ID in Kuroco.
Notification message IDSent message ID in Kuroco.

For more information on Sendgrid Webhooks, see SendGrid Documentation: Event Webhook Reference.

Buttons

Image from Gyazo

ButtonDescription 
SearchSearch based on the above settings.
DownloadDownload a list of the displayed logs.
DeleteDelete a list of the displayed logs.

Log list download

After click [Download] button, the download settings will open.

Image from Gyazo

Field(s)Description 
CharsetCharacter encoding of the output CSV file.
CancelCancel downloading.
DownloadExecute downloading.

If you have any other questions, please use our contact form or Slack workspace.