PHPackages                             williamtome/loki - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Logging & Monitoring](/categories/logging)
4. /
5. williamtome/loki

ActiveLibrary[Logging & Monitoring](/categories/logging)

williamtome/loki
================

A package for send application logs to Grafana Loki.

v1.0.2(1y ago)0121MITPHP

Since Sep 12Pushed 1y ago1 watchersCompare

[ Source](https://github.com/williamtome/loki)[ Packagist](https://packagist.org/packages/williamtome/loki)[ RSS](/packages/williamtome-loki/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (4)Versions (4)Used By (0)

Loki
====

[](#loki)

Esse pacote tem a finalidade de enviar logs da sua aplicação para o serviço do Grafana Loki.

Possui suporte para Laravel 8+ e PHP 8.0+

Instalação
----------

[](#instalação)

Para instalar o pacote, basta usar o composer:

```
composer require williamtome/loki
```

Não é preciso publicar o pacote nos Providers da sua aplicação Laravel. Isso é feito de forma automática pelo auto discovery, durante a instalação.

Como Usar
---------

[](#como-usar)

Depois de instalado, vá até o arquivo `config/logging.php` da sua aplicação Laravel, na chave de array `channel` e adicione o código a abaixo:

```
// config/logging.php

'channel' => [
    // outros channels padrão do Laravel...

    'loki' => [
        'driver' => 'custom',
        'level' => env('LOKI_LOGLEVEL', 'info'),
        'via' => Williamtome\Loki\LokiFactory::class,
        'configApi' => [
            'entrypoint' => env('LOKI_ENTRYPOINT', getenv('LOKI_HOST')),
            'globalLabels' => ['job' => env('APP_NAME', 'ProjectName')]
        ]
    ],
]
```

Também é necessário adicionar as seguintes variáveis de ambiente no seu `.env`:

```
CUSTOMER_NAME
NETWORK
LOKI_ENTRYPOINT
LOKI_HOST

```

**Explicação das variáveis:**

- CUSTOMER\_NAME - É o nome da empresa na qual está usando a sua aplicação.
- NETWORK - É o nome da rede do container Docker que a sua aplicação está utilizando. Você consegue visualizar isso no `docker-compose.yml` na parte de `network`.
- LOKI\_ENTRYPOINT e LOKI\_HOST - É a url do serviço do Loki que está sendo executado no seu container Docker. Exemplo: `http://url-do-servico-loki:3100`.

Alterar o valor da variável `APP_NAME` com o nome da sua aplicação.

Altere o valor da variável `LOG_CHANNEL` para `loki`.

```
LOG_CHANNEL=loki

```

Licença
-------

[](#licença)

Loki é um software open source licenciado sob a Licença MIT.

###  Health Score

24

—

LowBetter than 32% of packages

Maintenance35

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

3

Last Release

613d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/b4ec86e20b9c3cf666bee77c760f176098805eb5e5206ce56903cef1cff5e3eb?d=identicon)[williamtome](/maintainers/williamtome)

---

Top Contributors

[![william-helioprint](https://avatars.githubusercontent.com/u/135655970?v=4)](https://github.com/william-helioprint "william-helioprint (4 commits)")

### Embed Badge

![Health badge](/badges/williamtome-loki/health.svg)

```
[![Health](https://phpackages.com/badges/williamtome-loki/health.svg)](https://phpackages.com/packages/williamtome-loki)
```

###  Alternatives

[spatie/laravel-health

Monitor the health of a Laravel application

86910.0M83](/packages/spatie-laravel-health)[illuminate/log

The Illuminate Log package.

6224.3M518](/packages/illuminate-log)[freshbitsweb/laravel-log-enhancer

Make debugging easier by adding more data to your laravel logs

346569.0k](/packages/freshbitsweb-laravel-log-enhancer)[marvinlabs/laravel-discord-logger

Logging to a discord channel in Laravel

2081.1M2](/packages/marvinlabs-laravel-discord-logger)[larabug/larabug

Laravel 6.x/7.x/8.x/9.x/10.x/11.x/12.x/13.x bug notifier

299549.3k1](/packages/larabug-larabug)[honeybadger-io/honeybadger-laravel

Honeybadger Laravel integration

431.2M](/packages/honeybadger-io-honeybadger-laravel)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)