PHPackages                             antonioguimaraes/vendala-sdk-log-php - 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. antonioguimaraes/vendala-sdk-log-php

ActiveLibrary

antonioguimaraes/vendala-sdk-log-php
====================================

SDK em php do micro serviço de logs

1.7(5y ago)04.6kMITPHP

Since Jun 3Pushed 3y ago1 watchersCompare

[ Source](https://github.com/grazianilog/vendala-sdk-log-php)[ Packagist](https://packagist.org/packages/antonioguimaraes/vendala-sdk-log-php)[ RSS](/packages/antonioguimaraes-vendala-sdk-log-php/feed)WikiDiscussions master Synced yesterday

READMEChangelog (8)Dependencies (1)Versions (9)Used By (0)

Venda.la LOGS
=============

[](#vendala-logs)

#### SDK em PHP para o micro serviço de logs.

[](#sdk-em-php-para-o-micro-serviço-de-logs)

Este pacote visa padronizar o envio para o micro serviço de logs.

`Instalação`

Para instalar este pacote no projeto utilize o comando:

```
composer require antonioguimaraes/vendala-sdk-log-php

```

Feito isto, basta adicionar o uso da classe que você já terá acesso a todo poder do sdk.

`Documentação`

[![image info](mslog.png)](mslog.png)
-------------------------------------

[](#)

`Explicando`

```
Nossos sistemas precisam guardar logs diariamente.
Como não temos um lugar centralizado, este projeto visa centralizar e guardar tudo.

Nossas aplicações vão utilizar este SDK para enviar ao elasticsearch com o kinesis de intermediário.

Lifecycle de envio resumido:

1 - sistema venda.la tem necessidade de log.
2 - sistema venda.la chama sdk.
3 - sistema venda.la envia log a partir do sdk.
4 - sdk se comunica com o kinesis da aws enviando o payload e dados da aplicação.
5 - kinesis abre a stream e envia ao elasticsearch em lotes.
6 - em paralelo, é guardado num s3 o dado bruto para data mining futuro.
7 - fim do ciclo de vida.

Lifecycle de consumo resumido:

1 - aplicação necessita de log(usuário clicou num histórico de estoque).
2 - aplicação chama um api gateway (http://apivendala.amazon-us-east1.blablabla/logs/log/estoque/123/123/123)
3 - o api gateway invoca um lambda que consulta no elasticsearch buscando dados a partir do query string informado no api gateway e retorna os dados para quem invocou.
4 - com a posse dos dados, o api gateway retorna a resposta do lambda para a aplicação consumir e mostrar ao usuário.
5 - fim do ciclo de vida.

```

`Observações`

```
Existem dois tipos de log level:

1 - history | logs que o usuário final vê, como alteração de estoque e preço.
2 - log | logs que auditam as rotinas como envio de estoque, sincronia diária, alteração de preço, split de estoque.

Tempo de expiração do log por level:
------------------------------------
Level      |    TTL     |   Desc
history    |    n/a     |   logs que o usuário final vê, como alteração de estoque e preço.
log        |    90d     |   logs que auditam as rotinas como envio de estoque, sincronia diária, alteração de preço, split de estoque.
------------------------------------

Funções disponíveis no SDK:
------------------------------------
Nome            |   Desc            |   Exemplo
setLogType      |   tipo de log     |   price_change, stock_change, order_history
setAction       |   tipo da ação    |   manual,automatic,callback,job
setKey          |   set access key  |   ASDASDASDASD
setSecret       |   set secret key  |   DSADHASUDHAU
setWellExecuted |   sucesso na exec |   true | false
setLevel        |   nível de log    |   history | log
setEnvironment  |   tipo de env     |   local | dev | prod
setApp          |   aplicação       |   vendala | simplifique | lambdared | pickingpack | questions
setUid          |   coluna ref      |   universal_id (primary key)
setTable        |   tabela logada   |   skus
setDatabase     |   db logado       |   vendala2020
addMessage      |   adiciona msgs   |   "passou aqui 123"
addException    |   adiciona excep  |   throw new Exception('EXCP')
addProp         |   adiciona props  |   $prop1 = []; $prop2 = stdClass;
addMethod       |   adiciona funcs  |   func1(); func2(); func3();
sendLog         |   função de envio |   envia o log ao kinesis
------------------------------------

Padrão de nomenclatura:
lowerCamelCase.

```

`Testes disponíveis`

```
1 - teste que valida o fluxo completo
2 - teste que valida informações mínimas obrigatórias

Para rodar os testes utilize:
vendor/bin/phpunit src/tests/setupTest.php

```

`Exemplo de json salvo no elasticsearch`

```
{
  "messages": [
    "começou a execução do processo de estoque",
    "estoque antigo: 123",
    "cliente alterou estoque para: 122"
  ],
  "methods": {
    "splitEstoque();": {
      "arguments": {
        "sku_id": 123,
        "old": 1,
        "new": 2
      },
      "logs": {
        "maoe": "vempraca",
        "asdfadf": "ggdfgfdg"
      }
    },
    "auditEstoque();": {
      "arguments": {
        "teste": "testado"
      },
      "logs": {
        "mas testou mesmo?": "sim"
      }
    },
    "blablabla();": {
      "arguments": {
        "foo": "bar"
      },
      "logs": [
        "passou por aqui"
      ]
    }
  },
  "props": {
    "sku_id": "123123",
    "sku": "TESTESDK",
    "shop_name": "testeantonio",
    "enterprise_id": 1,
    "old": "123",
    "new": "122"
  },
  "logType" : "stock_change",
  "level": "log",
  "env": "local",
  "app": "simplifique",
  "uid": "3333",
  "table": "skus",
  "database": "simplifique",
  "wellExecuted": true
}
```

###  Health Score

29

—

LowBetter than 60% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity17

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity60

Established project with proven stability

 Bus Factor1

Top contributor holds 81% 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 ~4 days

Total

8

Last Release

2139d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/17e53bf1f46e6d2611240d7be1d88464c98dcb45c264dd970f9b27ecadd74155?d=identicon)[acgfbr](/maintainers/acgfbr)

---

Top Contributors

[![acgfbr](https://avatars.githubusercontent.com/u/8755427?v=4)](https://github.com/acgfbr "acgfbr (17 commits)")[![JesielSNunes](https://avatars.githubusercontent.com/u/40892756?v=4)](https://github.com/JesielSNunes "JesielSNunes (4 commits)")

### Embed Badge

![Health badge](/badges/antonioguimaraes-vendala-sdk-log-php/health.svg)

```
[![Health](https://phpackages.com/badges/antonioguimaraes-vendala-sdk-log-php/health.svg)](https://phpackages.com/packages/antonioguimaraes-vendala-sdk-log-php)
```

###  Alternatives

[league/flysystem-aws-s3-v3

AWS S3 filesystem adapter for Flysystem.

1.6k263.6M790](/packages/league-flysystem-aws-s3-v3)[aws/aws-sdk-php-laravel

A simple Laravel 9/10/11/12/13 service provider for including the AWS SDK for PHP.

1.7k35.6M75](/packages/aws-aws-sdk-php-laravel)[humanmade/s3-uploads

WordPress plugin to store uploads on S3

2.1k2.4M9](/packages/humanmade-s3-uploads)[bref/laravel-bridge

An advanced Laravel integration for Bref, including Octane support.

3384.1M11](/packages/bref-laravel-bridge)[magento/magento2-functional-testing-framework

Magento2 Functional Testing Framework

15511.5M30](/packages/magento-magento2-functional-testing-framework)[laravel-notification-channels/aws-sns

Amazon Simple Notification Service (AWS SNS) notification channel for Laravel.

541.1M2](/packages/laravel-notification-channels-aws-sns)

PHPackages © 2026

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