{"_id":"@breadstone/ziegel-platform-logging","_rev":"9-cc57c0866382c56b8099b5ac6c7b416a","name":"@breadstone/ziegel-platform-logging","dist-tags":{"latest":"0.0.9"},"versions":{"0.0.1":{"name":"@breadstone/ziegel-platform-logging","version":"0.0.1","author":{"url":"https://www.breadstone.de","name":"andre.wehlert","email":"awehlert@breadstone.de"},"license":"MIT","_id":"@breadstone/ziegel-platform-logging@0.0.1","maintainers":[{"name":"ruederennes","email":"realsancezz@gmail.com"}],"bugs":{"url":"https://breadstone.visualstudio.com/ziegel/_workitems/create/Bug"},"dist":{"shasum":"e4c8d4ce0d95125d9caebc2265dae60aca867f6c","tarball":"https://registry.npmjs.org/@breadstone/ziegel-platform-logging/-/ziegel-platform-logging-0.0.1.tgz","fileCount":127,"integrity":"sha512-81doiV4VKZEKHozONYUXYb69l/Au8cqAugnFICzoLockGfJdH9ehc9l+UHIEiwkFnLBZfx3z3wvT0nVPaTbjIQ==","signatures":[{"sig":"MEUCIBhIxUCCf9ZRd5tSuP8BlrTbuPki0aZYFUDvFesm/EymAiEA5L5NZVYEX8oHPYahLxELPJ69sD20wIL+ghyCR//iFLg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":282627},"main":"./Index.js","types":"./Index.d.ts","module":"./Index.js","gitHead":"6e85e7a52b57c3f29013f4fd6383076cd22dc9a0","typings":"./Index.d.ts","_npmUser":{"name":"ruederennes","actor":{"name":"ruederennes","type":"user","email":"realsancezz@gmail.com"},"email":"realsancezz@gmail.com"},"commonjs":"./Index.js","repository":{"url":"https://breadstone.visualstudio.com/ziegel/_git/ziegel","type":"git"},"_npmVersion":"11.3.0","description":"Includes logging functions for logging different states or types.","directories":{},"_nodeVersion":"24.0.1","dependencies":{"tslib":"^2.8.1","@breadstone/ziegel-core":"0.0.1","@breadstone/ziegel-platform":"0.0.1"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/ziegel-platform-logging_0.0.1_1750993736561_0.6367204001031286","host":"s3://npm-registry-packages-npm-production"}},"0.0.2":{"name":"@breadstone/ziegel-platform-logging","version":"0.0.2","author":{"url":"https://www.breadstone.de","name":"andre.wehlert","email":"awehlert@breadstone.de"},"license":"MIT","_id":"@breadstone/ziegel-platform-logging@0.0.2","maintainers":[{"name":"ruederennes","email":"realsancezz@gmail.com"}],"bugs":{"url":"https://breadstone.visualstudio.com/ziegel/_workitems/create/Bug"},"dist":{"shasum":"9a0342679756b5fe8477256fe77c8125e7009b53","tarball":"https://registry.npmjs.org/@breadstone/ziegel-platform-logging/-/ziegel-platform-logging-0.0.2.tgz","fileCount":128,"integrity":"sha512-j62R4GDPgQyKwCoeVJ1z5JtyCXDF/m5+KNYodYzK3fT1O/wcIyil7p4U5SF6BLE5nZIHuGTFntgV0xKSOBrMdQ==","signatures":[{"sig":"MEUCIEsM81v26G/MqzqoOrAfekHTrrq1DNE8t/72OOWKlQSpAiEAjZTx/qNMH+nOiUpQpWYMpdPgeNZ9WQpHgx8Vz6wIH1Q=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":283090},"main":"./Index.js","types":"./Index.d.ts","module":"./Index.js","gitHead":"810d476703d4a1544150277fa8510b8110622415","typings":"./Index.d.ts","_npmUser":{"name":"ruederennes","actor":{"name":"ruederennes","type":"user","email":"realsancezz@gmail.com"},"email":"realsancezz@gmail.com"},"commonjs":"./Index.js","repository":{"url":"https://breadstone.visualstudio.com/ziegel/_git/ziegel","type":"git"},"_npmVersion":"11.3.0","description":"Includes logging functions for logging different states or types.","directories":{},"_nodeVersion":"24.0.1","dependencies":{"tslib":"^2.8.1","@breadstone/ziegel-core":"0.0.2","@breadstone/ziegel-platform":"0.0.2"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/ziegel-platform-logging_0.0.2_1750994517180_0.22838162514708582","host":"s3://npm-registry-packages-npm-production"}},"0.0.3":{"name":"@breadstone/ziegel-platform-logging","version":"0.0.3","author":{"url":"https://www.breadstone.de","name":"andre.wehlert","email":"awehlert@breadstone.de"},"license":"MIT","_id":"@breadstone/ziegel-platform-logging@0.0.3","maintainers":[{"name":"ruederennes","email":"npm@breadstone.de"}],"homepage":"https://github.com/RueDeRennes/ziegel#readme","bugs":{"url":"https://github.com/RueDeRennes/ziegel/issues"},"dist":{"shasum":"e60c246a5505a2b11884742a587beaf2e78f0749","tarball":"https://registry.npmjs.org/@breadstone/ziegel-platform-logging/-/ziegel-platform-logging-0.0.3.tgz","fileCount":124,"integrity":"sha512-2EKDlkz8dE6fl8k35/qAiUiv2NhiFvXA0pawE9EtAcwZqhjZKSUFAjQA6dpu0IPTZXjTIac4y6pqpDJv2WkF4A==","signatures":[{"sig":"MEUCIGMYedFw38dpkXDjYq8QIFBfsbyy2gfIgY8Q9ISx/BYoAiEAnhdUTKnHK2h3sbMsFXMpMglKWPCRQQXQuMRhRhtwEls=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":96036},"main":"./Index.js","types":"./Index.d.ts","module":"./Index.js","gitHead":"b4d03ca0908154138403f2a27ca8efb54bee6e80","typings":"./Index.d.ts","_npmUser":{"name":"ruederennes","actor":{"name":"ruederennes","type":"user","email":"npm@breadstone.de"},"email":"npm@breadstone.de"},"commonjs":"./Index.js","repository":{"url":"git+https://github.com/RueDeRennes/ziegel.git","type":"git"},"_npmVersion":"10.9.2","description":"Includes logging functions for logging different states or types.","directories":{},"_nodeVersion":"22.17.0","dependencies":{"tslib":"^2.8.1","@breadstone/ziegel-core":"0.0.3","@breadstone/ziegel-platform":"0.0.3"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/ziegel-platform-logging_0.0.3_1751575589200_0.6604390485053913","host":"s3://npm-registry-packages-npm-production"}},"0.0.4":{"name":"@breadstone/ziegel-platform-logging","version":"0.0.4","author":{"url":"https://www.breadstone.de","name":"andre.wehlert","email":"awehlert@breadstone.de"},"license":"MIT","_id":"@breadstone/ziegel-platform-logging@0.0.4","maintainers":[{"name":"ruederennes","email":"npm@breadstone.de"}],"homepage":"https://github.com/RueDeRennes/ziegel#readme","bugs":{"url":"https://github.com/RueDeRennes/ziegel/issues"},"dist":{"shasum":"e4299fab82e1829084178cc612962d84b9ca3cbb","tarball":"https://registry.npmjs.org/@breadstone/ziegel-platform-logging/-/ziegel-platform-logging-0.0.4.tgz","fileCount":124,"integrity":"sha512-9opNY4imrLMWEv03FmbJ2RGjXO2poDTsxqlrGA2tVjgTBoc2JRKIPdQtFFZFLTMPjRLUGOu4Hs52dLNjn1WXFg==","signatures":[{"sig":"MEUCIARu6YDtUorhhQygzDolpvVp7hhCF3jDoJgKOSSQOLU6AiEAzvme5u8COoPHEs9Wa8P00NV8s2Ong0x0e2jfc3XDFwk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":96036},"main":"./Index.js","types":"./Index.d.ts","module":"./Index.js","gitHead":"87efb239ae0aa6121dc170cd110bc9be7bb0c622","typings":"./Index.d.ts","_npmUser":{"name":"ruederennes","actor":{"name":"ruederennes","type":"user","email":"npm@breadstone.de"},"email":"npm@breadstone.de"},"commonjs":"./Index.js","repository":{"url":"git+https://github.com/RueDeRennes/ziegel.git","type":"git"},"_npmVersion":"10.9.2","description":"Includes logging functions for logging different states or types.","directories":{},"_nodeVersion":"22.17.0","dependencies":{"tslib":"^2.8.1","@breadstone/ziegel-core":"0.0.4","@breadstone/ziegel-platform":"0.0.4"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/ziegel-platform-logging_0.0.4_1751576112904_0.7810020324602875","host":"s3://npm-registry-packages-npm-production"}},"0.0.5":{"name":"@breadstone/ziegel-platform-logging","version":"0.0.5","author":{"url":"https://www.breadstone.de","name":"andre.wehlert","email":"awehlert@breadstone.de"},"license":"MIT","_id":"@breadstone/ziegel-platform-logging@0.0.5","maintainers":[{"name":"ruederennes","email":"npm@breadstone.de"}],"homepage":"https://github.com/RueDeRennes/ziegel#readme","bugs":{"url":"https://github.com/RueDeRennes/ziegel/issues"},"dist":{"shasum":"d03b873c36749f152fc5420698676a6c2530e0e6","tarball":"https://registry.npmjs.org/@breadstone/ziegel-platform-logging/-/ziegel-platform-logging-0.0.5.tgz","fileCount":124,"integrity":"sha512-EJMBNNaSSe/8IgWtD03IuEIPPlTwokhB/7ANtIoxX8RNm9SkYIJUJAV8aAzWdYFXd3KJ1HKw/CEdxIFERbc0Zg==","signatures":[{"sig":"MEUCIBHKRgLWdn3Lr51fMnncZArsTxNjDRDhjZu6SKukMdTqAiEApDfq4/KQvS9Sh/6xqpvVekLqtgmYgPK/JSunrNEgEP0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":99775},"main":"./Index.js","types":"./Index.d.ts","module":"./Index.js","gitHead":"7eb0efd9f6fa2d25da83ba6a3bd737a0da028bf7","typings":"./Index.d.ts","_npmUser":{"name":"ruederennes","actor":{"name":"ruederennes","type":"user","email":"npm@breadstone.de"},"email":"npm@breadstone.de"},"commonjs":"./Index.js","repository":{"url":"git+https://github.com/RueDeRennes/ziegel.git","type":"git"},"_npmVersion":"9.8.1","description":"Includes logging functions for logging different states or types.","directories":{},"_nodeVersion":"22.16.0","dependencies":{"tslib":"^2.8.1","@breadstone/ziegel-core":"0.0.5","@breadstone/ziegel-platform":"0.0.5"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/ziegel-platform-logging_0.0.5_1751699284699_0.3552217179685606","host":"s3://npm-registry-packages-npm-production"}},"0.0.6":{"name":"@breadstone/ziegel-platform-logging","version":"0.0.6","author":{"url":"https://www.breadstone.de","name":"andre.wehlert","email":"awehlert@breadstone.de"},"license":"MIT","_id":"@breadstone/ziegel-platform-logging@0.0.6","maintainers":[{"name":"ruederennes","email":"npm@breadstone.de"}],"homepage":"https://github.com/RueDeRennes/ziegel#readme","bugs":{"url":"https://github.com/RueDeRennes/ziegel/issues"},"dist":{"shasum":"61fb60543629b0f2b1836d6673f459bf7cf53745","tarball":"https://registry.npmjs.org/@breadstone/ziegel-platform-logging/-/ziegel-platform-logging-0.0.6.tgz","fileCount":124,"integrity":"sha512-Yv0JcaLXD862O9clLnIfD71h3QD+z6JLo8oD48ptYZjdLf1HJ1ipmiN6WewgDfkZUVLb7ueiuBubr/DO+hiCVA==","signatures":[{"sig":"MEUCIBEwKBB41aANWc4r8Qwf7etLbbqoHhTDxeV4I1M3y0weAiEA9jQ54xLtl8fIK2MYRAcwtIHfXB64Q6fOObZSVLprMow=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":104288},"main":"./Index.js","types":"./Index.d.ts","module":"./Index.js","gitHead":"6d8252f646265878cb7ebb33936cdc87a1220836","typings":"./Index.d.ts","_npmUser":{"name":"ruederennes","email":"npm@breadstone.de"},"commonjs":"./Index.js","repository":{"url":"git+https://github.com/RueDeRennes/ziegel.git","type":"git"},"_npmVersion":"11.4.2","description":"Includes logging functions for logging different states or types.","directories":{},"_nodeVersion":"24.4.1","dependencies":{"tslib":"^2.8.1","@breadstone/ziegel-core":"0.0.6","@breadstone/ziegel-platform":"0.0.6"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/ziegel-platform-logging_0.0.6_1754467850302_0.8726613807514789","host":"s3://npm-registry-packages-npm-production"}},"0.0.7":{"name":"@breadstone/ziegel-platform-logging","version":"0.0.7","author":{"url":"https://www.breadstone.de","name":"andre.wehlert","email":"awehlert@breadstone.de"},"license":"MIT","_id":"@breadstone/ziegel-platform-logging@0.0.7","maintainers":[{"name":"ruederennes","email":"npm@breadstone.de"}],"homepage":"https://github.com/RueDeRennes/ziegel#readme","bugs":{"url":"https://github.com/RueDeRennes/ziegel/issues"},"dist":{"shasum":"c8484679fea25d9a8541cf570b4987133a4180a9","tarball":"https://registry.npmjs.org/@breadstone/ziegel-platform-logging/-/ziegel-platform-logging-0.0.7.tgz","fileCount":124,"integrity":"sha512-DZz2foy8S7kSyZWiUxeQE9gt9ElWWADKGy2Ugjl1tH7TGf8+l/ya9YOEzBgG01YmRgLzo5n3A2n2M5ah36uFfw==","signatures":[{"sig":"MEUCIQCSDux/HbH8pQgYwReoxwQ21vt7R3cUp83a/HRBhTkpYQIgHp4pZF+Hv6XUBAIbl9mp6567C8T7WMoC/5vGS0slD/E=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":104288},"main":"./Index.js","types":"./Index.d.ts","module":"./Index.js","gitHead":"7647e351d85d9dfbae9e9e9d84095559a75822d3","typings":"./Index.d.ts","_npmUser":{"name":"ruederennes","email":"npm@breadstone.de"},"commonjs":"./Index.js","repository":{"url":"git+https://github.com/RueDeRennes/ziegel.git","type":"git"},"_npmVersion":"11.4.2","description":"Includes logging functions for logging different states or types.","directories":{},"_nodeVersion":"24.4.1","dependencies":{"tslib":"^2.8.1","@breadstone/ziegel-core":"0.0.7","@breadstone/ziegel-platform":"0.0.7"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/ziegel-platform-logging_0.0.7_1754468254833_0.9853086575411234","host":"s3://npm-registry-packages-npm-production"}},"0.0.8":{"name":"@breadstone/ziegel-platform-logging","version":"0.0.8","author":{"url":"https://www.breadstone.de","name":"andre.wehlert","email":"awehlert@breadstone.de"},"license":"MIT","_id":"@breadstone/ziegel-platform-logging@0.0.8","maintainers":[{"name":"ruederennes","email":"npm@breadstone.de"}],"homepage":"https://github.com/RueDeRennes/ziegel#readme","bugs":{"url":"https://github.com/RueDeRennes/ziegel/issues"},"dist":{"shasum":"6e6e02ad5c80ec88d4313cedea508d8c77b9252f","tarball":"https://registry.npmjs.org/@breadstone/ziegel-platform-logging/-/ziegel-platform-logging-0.0.8.tgz","fileCount":124,"integrity":"sha512-R0AL9lMlhNcS0lvxHvQVtWjgohWKplSNC0OaTMWoiWdZMO+HaEcqFUOCGxU8m8x/5UYAHS0pogrcdByOt+nD5A==","signatures":[{"sig":"MEUCIQDKr7rfFy6w6Y5D4NDPWkdk1ntxhM4hT1ceMG4cebks+gIgT+OKv7VXDGJdqAEVABluEMnq2v1unCKbjNW+pJqU9Ck=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":102501},"main":"./Index.js","types":"./Index.d.ts","module":"./Index.js","gitHead":"22e93d6ad15b55bd3286eddabbd94ea896f498e0","typings":"./Index.d.ts","_npmUser":{"name":"ruederennes","email":"npm@breadstone.de"},"commonjs":"./Index.js","repository":{"url":"git+https://github.com/RueDeRennes/ziegel.git","type":"git"},"_npmVersion":"11.4.2","description":"Includes logging functions for logging different states or types.","directories":{},"_nodeVersion":"24.4.1","dependencies":{"tslib":"^2.8.1","@breadstone/ziegel-core":"0.0.8","@breadstone/ziegel-platform":"0.0.8"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/ziegel-platform-logging_0.0.8_1754745274664_0.45330251366783836","host":"s3://npm-registry-packages-npm-production"}},"0.0.9":{"name":"@breadstone/ziegel-platform-logging","version":"0.0.9","description":"Includes logging functions for logging different states or types.","license":"MIT","author":{"name":"andre.wehlert","email":"awehlert@breadstone.de","url":"https://www.breadstone.de"},"main":"./Index.js","module":"./Index.js","commonjs":"./Index.js","typings":"./Index.d.ts","types":"./Index.d.ts","repository":{"type":"git","url":"git+https://github.com/RueDeRennes/ziegel.git"},"bugs":{"url":"https://github.com/RueDeRennes/ziegel/issues"},"dependencies":{"@breadstone/ziegel-core":"0.0.9","@breadstone/ziegel-platform":"0.0.9","tslib":"^2.8.1"},"_id":"@breadstone/ziegel-platform-logging@0.0.9","gitHead":"efc417cb60db843da253c8b83aa7ea54fe94ed5f","homepage":"https://github.com/RueDeRennes/ziegel#readme","_nodeVersion":"24.4.1","_npmVersion":"11.4.2","dist":{"integrity":"sha512-qqriGs2nDCmXWNUiwsew0n2df1vSdEU1ODztO1kHTsZHXBW5YunvJjHO+GNdSc2fxqMtktUHsnAi6IpGjWXsCg==","shasum":"7bd7716c91f45e2a1e5c567c31be29ac662a2e25","tarball":"https://registry.npmjs.org/@breadstone/ziegel-platform-logging/-/ziegel-platform-logging-0.0.9.tgz","fileCount":124,"unpackedSize":102501,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIHa/OuGwJ1SdWJbNdQ36M6pJc20CKmkVulU1qx94n3c3AiBAaMJmEpEBROg5Q2/2Q6I2+g6I3WKBei6ozmKg4BZMPQ=="}]},"_npmUser":{"name":"ruederennes","email":"npm@breadstone.de"},"directories":{},"maintainers":[{"name":"ruederennes","email":"npm@breadstone.de"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/ziegel-platform-logging_0.0.9_1756450307306_0.9915428382717009"},"_hasShrinkwrap":false}},"time":{"created":"2025-06-27T03:08:56.482Z","modified":"2025-08-29T06:51:47.679Z","0.0.1":"2025-06-27T03:08:56.761Z","0.0.2":"2025-06-27T03:21:57.417Z","0.0.3":"2025-07-03T20:46:29.379Z","0.0.4":"2025-07-03T20:55:13.070Z","0.0.5":"2025-07-05T07:08:04.870Z","0.0.6":"2025-08-06T08:10:50.476Z","0.0.7":"2025-08-06T08:17:35.029Z","0.0.8":"2025-08-09T13:14:34.862Z","0.0.9":"2025-08-29T06:51:47.486Z"},"bugs":{"url":"https://github.com/RueDeRennes/ziegel/issues"},"author":{"name":"andre.wehlert","email":"awehlert@breadstone.de","url":"https://www.breadstone.de"},"license":"MIT","homepage":"https://github.com/RueDeRennes/ziegel#readme","repository":{"type":"git","url":"git+https://github.com/RueDeRennes/ziegel.git"},"description":"Includes logging functions for logging different states or types.","maintainers":[{"name":"ruederennes","email":"npm@breadstone.de"}],"readme":"# @breadstone/ziegel-platform-logging\r\n\r\n[![MIT License](https://img.shields.io/badge/License-MIT-green.svg)](https://choosealicense.com/licenses/mit/)\r\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue.svg)](https://www.typescriptlang.org/)\r\n[![npm](https://img.shields.io/badge/npm-@breadstone/ziegel--platform--logging-red.svg)](https://www.npmjs.com/package/@breadstone/ziegel-platform-logging)\r\n\r\nEnterprise logging and diagnostics infrastructure for the ziegel platform. Provides structured logging, multiple appenders, log levels, correlation tracking, and centralized log management for distributed applications.\r\n\r\n> **Logging**: Enterprise-grade logging with structured output, correlation tracking, and centralized management.\r\n\r\n## 🚀 Overview\r\n\r\n`@breadstone/ziegel-platform-logging` provides:\r\n- **Structured Logging**: JSON-formatted logs with metadata\r\n- **Multiple Appenders**: Console, file, database, and remote logging\r\n- **Log Levels**: Configurable logging levels and filtering\r\n- **Correlation Tracking**: Request correlation and distributed tracing\r\n- **Performance Logging**: Method execution and performance tracking\r\n- **Log Aggregation**: Centralized log collection and analysis\r\n- **Security Logging**: Audit trails and security event logging\r\n\r\n## 📦 Installation\r\n\r\n```bash\r\nnpm install @breadstone/ziegel-platform-logging\r\n# or\r\nyarn add @breadstone/ziegel-platform-logging\r\n```\r\n\r\n## 🧩 Features & Usage Examples\r\n\r\n### Basic Logging\r\n\r\n```typescript\r\nimport { Logger, LoggerFactory } from '@breadstone/ziegel-platform-logging';\r\n\r\nconst logger = LoggerFactory.getLogger('MyService');\r\n\r\n// Different log levels\r\nlogger.debug('Debug information', { userId: '123' });\r\nlogger.info('User logged in', { userId: '123', ip: '192.168.1.1' });\r\nlogger.warn('Rate limit exceeded', { userId: '123', attempts: 5 });\r\nlogger.error('Database connection failed', { error: 'Connection timeout' });\r\n```\r\n\r\n### Structured Logging\r\n\r\n```typescript\r\nimport { StructuredLogger, LogContext } from '@breadstone/ziegel-platform-logging';\r\n\r\nconst logger = new StructuredLogger('OrderService');\r\n\r\n// Log with structured data\r\nlogger.info('Order created', {\r\n  orderId: 'ORD-123',\r\n  customerId: 'CUST-456',\r\n  amount: 99.99,\r\n  items: [\r\n    { sku: 'ITEM-1', quantity: 2 },\r\n    { sku: 'ITEM-2', quantity: 1 }\r\n  ]\r\n});\r\n```\r\n\r\n### Log Configuration\r\n\r\n```typescript\r\nimport { LoggerConfiguration, ConsoleAppender, FileAppender } from '@breadstone/ziegel-platform-logging';\r\n\r\nconst config = new LoggerConfiguration()\r\n  .setLevel('info')\r\n  .addAppender(new ConsoleAppender({\r\n    format: 'json',\r\n    colorize: true\r\n  }))\r\n  .addAppender(new FileAppender({\r\n    filename: 'logs/app.log',\r\n    maxSize: '10MB',\r\n    maxFiles: 5,\r\n    compress: true\r\n  }));\r\n\r\nLoggerFactory.configure(config);\r\n```\r\n\r\n### Correlation Tracking\r\n\r\n```typescript\r\nimport { CorrelationContext, CorrelationMiddleware } from '@breadstone/ziegel-platform-logging';\r\n\r\n// Express middleware for correlation tracking\r\napp.use(CorrelationMiddleware());\r\n\r\n// Use correlation in services\r\nclass UserService {\r\n  private logger = LoggerFactory.getLogger('UserService');\r\n  \r\n  async getUser(id: string) {\r\n    const correlationId = CorrelationContext.getId();\r\n    this.logger.info('Fetching user', { \r\n      userId: id, \r\n      correlationId \r\n    });\r\n    \r\n    // All logs in this request will have the same correlationId\r\n    return await this.userRepository.findById(id);\r\n  }\r\n}\r\n```\r\n\r\n### Performance Logging\r\n\r\n```typescript\r\nimport { PerformanceLogger, LogPerformance } from '@breadstone/ziegel-platform-logging';\r\n\r\nclass DatabaseService {\r\n  private logger = LoggerFactory.getLogger('DatabaseService');\r\n  \r\n  @LogPerformance()\r\n  async executeQuery(sql: string): Promise<any[]> {\r\n    // Method execution time will be automatically logged\r\n    return await this.database.query(sql);\r\n  }\r\n  \r\n  async manualTiming() {\r\n    const timer = this.logger.startTimer();\r\n    \r\n    // Perform operation\r\n    await this.heavyOperation();\r\n    \r\n    timer.done('Heavy operation completed');\r\n  }\r\n}\r\n```\r\n\r\n### Custom Appenders\r\n\r\n```typescript\r\nimport { LogAppender, LogEntry } from '@breadstone/ziegel-platform-logging';\r\n\r\nclass ElasticsearchAppender implements LogAppender {\r\n  constructor(private client: ElasticsearchClient) {}\r\n  \r\n  async write(entry: LogEntry): Promise<void> {\r\n    await this.client.index({\r\n      index: 'application-logs',\r\n      body: {\r\n        timestamp: entry.timestamp,\r\n        level: entry.level,\r\n        message: entry.message,\r\n        data: entry.data,\r\n        source: entry.source\r\n      }\r\n    });\r\n  }\r\n}\r\n\r\n// Register custom appender\r\nconfig.addAppender(new ElasticsearchAppender(esClient));\r\n```\r\n\r\n### Security Logging\r\n\r\n```typescript\r\nimport { SecurityLogger, AuditLogger } from '@breadstone/ziegel-platform-logging';\r\n\r\nconst securityLogger = new SecurityLogger();\r\nconst auditLogger = new AuditLogger();\r\n\r\n// Security events\r\nsecurityLogger.logLoginAttempt({\r\n  userId: '123',\r\n  success: true,\r\n  ip: '192.168.1.1',\r\n  userAgent: 'Mozilla/5.0...'\r\n});\r\n\r\nsecurityLogger.logPermissionDenied({\r\n  userId: '123',\r\n  resource: '/admin/users',\r\n  action: 'DELETE'\r\n});\r\n\r\n// Audit trail\r\nauditLogger.logDataAccess({\r\n  userId: '123',\r\n  table: 'users',\r\n  action: 'SELECT',\r\n  recordCount: 150\r\n});\r\n```\r\n\r\n### Log Filtering and Sampling\r\n\r\n```typescript\r\nimport { LogFilter, SamplingFilter, RegexFilter } from '@breadstone/ziegel-platform-logging';\r\n\r\n// Sample only 10% of debug logs\r\nconst samplingFilter = new SamplingFilter({\r\n  level: 'debug',\r\n  rate: 0.1\r\n});\r\n\r\n// Filter out sensitive data\r\nconst sensitiveFilter = new RegexFilter({\r\n  pattern: /password|secret|token/i,\r\n  replacement: '[REDACTED]'\r\n});\r\n\r\nconfig.addFilter(samplingFilter);\r\nconfig.addFilter(sensitiveFilter);\r\n```\r\n\r\n## 📚 Package import points\r\n\r\n```typescript\r\nimport {\r\n    // Core Logging\r\n    Logger,\r\n    LoggerFactory,\r\n    StructuredLogger,\r\n    LogLevel,\r\n    \r\n    // Configuration\r\n    LoggerConfiguration,\r\n    LogEntry,\r\n    \r\n    // Appenders\r\n    ConsoleAppender,\r\n    FileAppender,\r\n    DatabaseAppender,\r\n    RemoteAppender,\r\n    \r\n    // Correlation\r\n    CorrelationContext,\r\n    CorrelationMiddleware,\r\n    \r\n    // Performance\r\n    PerformanceLogger,\r\n    LogPerformance,\r\n    \r\n    // Security\r\n    SecurityLogger,\r\n    AuditLogger,\r\n    \r\n    // Filtering\r\n    LogFilter,\r\n    SamplingFilter,\r\n    RegexFilter\r\n} from '@breadstone/ziegel-platform-logging';\r\n```\r\n\r\n## 📚 API Documentation\r\n\r\nFor detailed API documentation, visit: [API Docs](./../../.docs/api/ziegel-platform-logging/index.md)\r\n\r\n## Related Packages\r\n\r\n- **@breadstone/ziegel-platform**: Core platform services\r\n- **@breadstone/ziegel-platform-configuration**: Configuration management\r\n- **@breadstone/ziegel-core**: Foundation utilities\r\n\r\n## License\r\n\r\nMIT\r\n\r\n## Issues\r\n\r\nPlease report bugs and feature requests in the [Issue Tracker](https://github.com/RueDeRennes/ziegel/issues)\r\n\r\n---\r\n\r\n*Part of the [ziegel Enterprise TypeScript Framework](../../README.md)*","readmeFilename":"README.md"}