{"id":15062617,"url":"https://github.com/jop-software/typo3-loki","last_synced_at":"2025-06-11T19:37:57.824Z","repository":{"id":37826377,"uuid":"489109772","full_name":"jop-software/typo3-loki","owner":"jop-software","description":"Grafana Loki Client integrated into TYPO3","archived":false,"fork":false,"pushed_at":"2024-11-11T12:44:59.000Z","size":82,"stargazers_count":2,"open_issues_count":6,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-10T10:37:00.678Z","etag":null,"topics":["grafana","grafana-loki","hacktoberfest","monitoring","typo3","typo3-cms-extension","typo3-extension"],"latest_commit_sha":null,"homepage":"https://extensions.typo3.org/extension/loki","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jop-software.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-05-05T19:59:22.000Z","updated_at":"2024-11-11T12:45:01.000Z","dependencies_parsed_at":"2025-02-17T01:31:47.675Z","dependency_job_id":"6496917f-a426-4c40-baad-4b47d9aa80c6","html_url":"https://github.com/jop-software/typo3-loki","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/jop-software/typo3-loki","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jop-software%2Ftypo3-loki","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jop-software%2Ftypo3-loki/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jop-software%2Ftypo3-loki/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jop-software%2Ftypo3-loki/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jop-software","download_url":"https://codeload.github.com/jop-software/typo3-loki/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jop-software%2Ftypo3-loki/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259325346,"owners_count":22841052,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["grafana","grafana-loki","hacktoberfest","monitoring","typo3","typo3-cms-extension","typo3-extension"],"created_at":"2024-09-24T23:43:43.841Z","updated_at":"2025-06-11T19:37:57.808Z","avatar_url":"https://github.com/jop-software.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n    \u003ch1\u003eTYPO3 Loki Client\u003c/h1\u003e\n    \u003cp\u003eMonitor logging output of your TYPO3 installation\u003c/p\u003e\n\u003c/div\u003e\n\n## Professional Support\nProfessional support is available, please contact [info@jop-software.de](mailto:info@jop-software.de) for more information.\n\n## Configuration\n\nThere are two possible ways to use this extension.\n\n1. Use the JsonWriter to convert all logs to JSON before writing them to the log file.  \nThis way, you can process the logs with a different loki client like [Promtail](https://grafana.com/docs/loki/latest/clients/promtail/)\n\n```php\n$GLOBALS['TYPO3_CONF_VARS']['LOG']['writerConfiguration'] = [\n    // Log handling configuration for ERROR logs\n    // Set this to DEBUG to process all logs.\n    \\TYPO3\\CMS\\Core\\Log\\LogLevel::ERROR =\u003e [\n        // Convert all logs to JSON to scrape them with loki clients like Promtail\n        \\Jops\\TYPO3\\Loki\\Log\\Writers\\JsonWriter::class =\u003e [],\n    ],\n];\n```\n\n2. Use the LokiWriter to send logs directly to a configured loki instance.  \nYou can define labels here, that will be attached to the log line sent to loki.  \nSee: [Configure a Loki instance](#configure-a-loki-instance)\n\n```php\n$GLOBALS['TYPO3_CONF_VARS']['LOG']['writerConfiguration'] = [\n    // Log handling configuration for ERROR logs\n    // Set this to DEBUG to process all logs.\n    \\TYPO3\\CMS\\Core\\Log\\LogLevel::ERROR =\u003e [\n        // Configure LokiWrite to send logs to Loki\n        \\Jops\\TYPO3\\Loki\\Log\\Writers\\LokiWriter::class =\u003e [\n            \"labels\" =\u003e [\n                \"key\" =\u003e \"value\",\n            ],\n        ],\n    ],\n];\n```\n\n### Configure a Loki instance.\n\nIf you want to use the LokiWriter, you need to have a loki instance configured. This can be done with the Extension \nConfiguration in the backend or in the `AdditionalConfiguration.php`.  \nIf your Loki installation is secured with http basic auth, you can provide those credentials here as well. Keep in mind\nthat the credentials **are store as plain text** in the configuration file.\n\nThis could be an example configuration:\n\n```php\n$GLOBALS['TYPO3_CONF_VARS']['EXTENSIONS']['loki'] = [\n    \"base-url\" =\u003e \"https://loki.example.com\",\n    // Optional: Add basic-auth credentials if needed\n    \"basic-auth\" =\u003e [\n        \"username\" =\u003e \"username\",\n        \"password\" =\u003e \"secure-password\",\n    ],\n];\n```\n## Supported TYPO3 Versions\nThe extension is only officially available and released for TYPO3 11.\n\nIf you need it in an older project, you can find a version that is compatible with TYPO3 9 and 10 in the [`typo3-9-10-compatability`](https://github.com/jop-software/typo3-loki/tree/typo3-9-10-compatability) branch.\nUse `dev-typo3-9-10-compatability` as the version in composer.\n\n## Local Development\nWe use [DDEV](https://ddev.com) for local development.\n\nYou get a complete ddev setup in this repository, just run `ddev start`.\n\n## License\nThis project is licensed under [GPL-2.0-or-later](https://www.gnu.org/licenses/old-licenses/gpl-2.0.html), see the [LICENSE](./LICENSE) file for more information.\n\n\u003cdiv align=\"center\"\u003e\n    \u003cp\u003e\u0026copy; 2022, \u003ca href=\"mailto:info@jop-software.de\"\u003ejop-software Inh. Johannes Przymusinski\u003c/a\u003e\u003c/p\u003e\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjop-software%2Ftypo3-loki","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjop-software%2Ftypo3-loki","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjop-software%2Ftypo3-loki/lists"}