Applications

The Applications resource in Laritor allows you to register and manage each application for which you want to collect performance data. This guide covers:

• Viewing a list of existing applications
• Creating a new application
• Deleting an application
• Viewing and editing application details
• Understanding automatically tracked environments

---

1. Applications Index

When you navigate to the Applications section, you will see an index table that lists all applications you have created. Each row includes:

• Name: The human-readable label you assigned when creating the application.
• Actions:
  • View 🔍: Opens the application’s detail page.
  • Delete 🗑️: Permanently removes this application and all related data.

Tip: If this is your first time, the table may be empty. Follow the steps below to add your first application.

1.1 Creating a New Application

1. Click the Add Application (or “+ Application”) button in the top-right corner of the index page.
2. A modal (or form) appears with a single input field:
   • Application Name: Enter a descriptive name (e.g., my-laravel-app, backend-api, mobile-client).
3. Click Save (or Create).
4. Upon successful creation, you will be shown a confirmation message and instructions to install the Laritor client package:
   1. Copy the provided Ingest URL.
   2. Follow the on-screen code snippet to install Laritor in your application (for example, via Composer).
   3. Configure your environment to point to the new ingest URL.

Once Laritor is installed and configured, your application will begin sending performance events immediately.

1.2 Deleting an Application

1. In the Applications index, locate the application you want to remove.
2. Click the Delete 🗑️ icon in the “Actions” column.
3. Confirm the deletion when prompted.
4. All performance data, settings, and environments associated with this application will be permanently removed.

Warning: Deletion is irreversible. If you have active ingest traffic pointed at this application, those events will fail once the application is deleted.

---

2. Application Details View

Clicking the View 🔍 icon for an application takes you to its detail page (e.g., /applications/{app_id}). This view is divided into two main sections:

1. Application Configuration
2. Environments

2.1 Application Configuration

At the top of the detail page, you will see:

• Application Name (editable)
• Ingest URL (copyable and regeneratable)

2.1.1 Rename the Application

1. Update the name in the text field.
2. Click Update.

The new name will immediately reflect throughout the Laritor dashboard and reporting views.

Note: Renaming does not affect your ingest URL or historical data; only the display label changes.

2.1.2 Regenerate Ingest URL

1. Under Ingest URL, click Regenerate.
2. Read the warning text carefully:

   Warning: Regenerating the ingest URL will invalidate your old URL. All existing Laritor installations that use the previous URL will stop sending events until they are updated with the new URL.

3. Confirm regeneration. A new ingest URL will be displayed.
4. Copy the updated URL and replace it in your application’s environment configuration.

Once updated, Laritor will begin ingesting events from the new URL. Any traffic to the old URL will return a 404 until you update the new url in your .env file.

---

3. Environments

Below the Application Configuration section, you will find a table listing all Environments associated with this application.

• Environment Name: Automatically detected from .env file.

Important: Environments are discovered dynamically. Laritor does not require you to manually add or remove them. As soon as your application’s Laritor client sends its first event, the environment appears in this list.