Download the PHP package einlinuus/linuus-observability without Composer

On this page you can find all versions of the php package einlinuus/linuus-observability. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of einlinuus/linuus-observability

Informations about the package linuus-observability

linu.us Observability

Packagist PHP from Packagist Laravel versions GitHub Workflow Status (main) Total Downloads

Observability agent for the linu.us observability system

Installation

You can install the package via Composer:

Install the package config and setup guidance:

Or publish only the config file manually:

Configuration

The package publishes config/observability.php:

Middleware registration

The package makes middleware available as observability.request, but does not register it globally.

Apply it where you want request-completed events:

Inertia validation responses

When inertiajs/inertia-laravel is installed, the middleware automatically recognizes Inertia validation redirects from their newly flashed Laravel error bag. These events use 422 for http.response.status_code so validation failures are not classified as successful redirects, while http.response.redirect_status_code preserves the observed 302 or 303.

Successful Inertia redirects, non-Inertia responses, and server errors keep their original status code. No Inertia configuration is required, and validation messages or submitted values are not recorded.

Capture regular Laravel logs (Log::info())

Add a linuus-observability channel in config/logging.php:

Then include it in your stack channel:

After that, normal Laravel log calls are captured to the same JSONL stream:

Custom and audit events

All events are written to local newline-delimited JSON at observability.log_path.

Run the local agent

Start the shipping process:

The agent:

  1. Reads observability.log_path.
  2. Tracks byte offset in storage/framework/cache/observability-agent.json.
  3. Sends batches to OBSERVABILITY_ENDPOINT with bearer auth.
  4. Retries failures without deleting local app logs.

Ingest payload format (stable for MVP)

The agent sends NDJSON over HTTP:

Continuous process examples

Run php artisan observability:agent as a long-running process in your host environment:

Restart the agent after a Forge deployment

Add this command to your Forge deployment script after Composer has installed the newly deployed package version:

The command asks the running agent to finish its current flush and exit successfully. Forge's daemon supervisor then starts it again with the newly deployed code.

When first upgrading from a package version that does not support observability:restart-agent, restart the Forge daemon once manually. Future deployments can use the deployment-script command.

Example log lines

Current scope

Non-goals (MVP)

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Thank you for considering contributing to linu.us Observability! Please review our contributing guide to get started.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

License

linu.us Observability is open-sourced software licensed under the MIT license.

All versions of linuus-observability with dependencies

PHP Build Version
Package Version
Requires php Version ^8.3
illuminate/support Version ^12.0||^13.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package einlinuus/linuus-observability contains the following files

Loading the files please wait ...