Vapor: UI Dashboard Package

Sep, 3 2020#vapor

Today we're proud to introduce you to our new open-source package: Vapor UI. In short, this package provides a beautiful dashboard within your Vapor powered application that allows you to monitor your application's logs and failed queue jobs.

Once you install the Vapor UI Dashboard in your application, you can visit /vapor-ui URI to access the dashboard:

dashboard

In this screenshot, you can see that the "Logs" tab will appear by default in addition to other information about the project.

Logs

As you may know, Laravel provides support for a variety of logging services. By default, when using Vapor, your application will use the AWS CloudWatch service when logging messages.

The "Logs" tab allows you to search your application's logs stored in AWS CloudWatch. In the navigation sidebar, you may choose between the HTTP, CLI, or Queue log layers.

Remember, even if you configure a different logging service for your application logs, the AWS CloudWatch service and Vapor UI will display your infrastructure logs as well. Infrastructure logs may include logs regarding AWS Lambda timeouts, etc.

You may filter your logs by a full-text search that looks inside the log information, by "Log type", or "Starting from" date:

full-text search

Consider always searching using a recent "Starting from" date. The CloudWatch API can have long response times while searching far into the past.

For better troubleshooting, you may also filter by "Timeout". It can be very useful to better understand why some requests result in a "502 Bad Gateway":

timeout

Of course, you can also see the log detail by clicking the "eye" icon close to the log:

job details

The log detail contains contain relevant information such as the log message, log payload, location of the error, and more.


Failed Jobs

Within the "Failed Jobs" tab, you can view the list of failed jobs, their names, the reason for failure, and the time of failure:

failed jobs

Of course, just like in the "Logs" tab, you can perform full-text search or filter by "Starting from" date. Once you enter the detail view of a failed job, you can access more information about the job, such as the job ID, connection, queue, and more.

Also, you may choose to retry or to delete the failed job:

image


Vapor UI documentation can be found here. We hope you enjoy this new package and thank you for your continued support of the Laravel ecosystem!

By Nuno Maduro

Laravel Team, Creator of Pest.

Follow the RSS Feed.