https://github.com/osskit/monitor
Monitor your services declaratively
https://github.com/osskit/monitor
logging metrics monitor monitoring prometheus
Last synced: 10 months ago
JSON representation
Monitor your services declaratively
- Host: GitHub
- URL: https://github.com/osskit/monitor
- Owner: osskit
- License: mit
- Created: 2021-07-23T13:00:57.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2024-06-16T11:21:06.000Z (almost 2 years ago)
- Last Synced: 2024-12-07T02:12:00.953Z (over 1 year ago)
- Topics: logging, metrics, monitor, monitoring, prometheus
- Language: TypeScript
- Homepage:
- Size: 308 KB
- Stars: 19
- Watchers: 1
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
 [](https://github.com/osskit/monitor/blob/master/LICENSE.md) [](https://github.com/prettier/prettier)
Utilize a declarative API to wrap your functions to capture Prometheus metrics & logs for each function
## Install
```sh
yarn add @osskit/monitor
```
## Usage
### Scoped
```ts
import { createMonitor } from '@osskit/monitor'
export const monitor = createMonitor({ scope: 'metrics' });
const result1 = await monitor('query', async () => db.query());
const result2 = await monitor('update', async () => db.update());
// Custom labeling
export const monitor = createMonitor<['my_label']>({ scope: 'metrics' });
const customLabels = (id: string) => await monitor('query', async () => db.query(id), {context: {key: 'myId' }, labeling: { 'my_label': 'label' } });
```
### Unscoped
```ts
import monitor from '@osskit/monitor'
const result = await monitor('query', async () => db.query());
// Custom labeling
const customLabels = (id: string) => await monitor('query', async () => db.query(id), {context: {key: 'myId' }, labeling: { 'my_label': 'label' } });
```
### With monitor options
```ts
import { createMonitor } from '@osskit/monitor'
export const monitor = createMonitor({ scope: 'metrics' });
// Context
const result = (id: string) => await monitor('query', async () => db.query(id), { context: { id } });
// Parse & Log Results
const logResults = (id: string) => await monitor('query', async () => db.query(id), { logResult: true, parseResult: (res) => res.prop });
// Parse Error
const errored = (id: string) => await monitor('query', async () => db.query(id), { logResult: true, parseError: (e) => e.statusCode });
// Log Execution Start
const executionStart = (id: string) => await monitor('query', async () => db.query(id), { logExecutionStart: true });
```
### With global options
```ts
import { setGlobalOptions, setGlobalContext } from '@osskit/monitor';
import logger from './logger.js';
setGlobalOptions({
context: { globalContextId: 'bla' },
logResult: true,
logExecutionStart: false,
parseError: (res) => console.log(res),
prometheusBuckets: [0.0001, 0.1, 0.5, 10],
logger,
errorLogLevel: 'fatal'
});
setGlobalContext(() => getDynamicContext());
```
## API
### createMonitor({ scope: string, options?: MonitorOptions })
#### scope
Type: `string`
The scope of the monitor's metrics
Will be used as the Prometheus metric name
Returns an instance of a function that calls `monitor` - `(method: string, callable: () => T, options?: MonitorOptions)`
### monitor(method: string, callable: () => T, options?: MonitorOptions)
#### method
Type: `string`
Will be used for the `method` label of the metric, or the metric name if no parent scope was declared
### setGlobalOptions({ options: MonitorGlobalOptions })
Set a number of options that will be used globally for all monitor invocations
### setGlobalContext(value: () => Record)
Invoke a function that returns a global context to use in all monitor invocation logs
### Parameters
#### MonitorOptions
| Parameter | Description |
|:-----------------------------------:|-----------------------------------------------------------------------------|
| `context?: boolean` | add context that will be logged in all method's logs |
| `logResult?: boolean` | log the method's result |
| `logExecutionStart?: boolean` | log the start of the method's execution `method.start` |
| `parseResult?: (e: any) => any` | transform the method's result that will be returned |
| `parseError?: (e: any) => any` | if the method errored, transform the error that will be thrown |
| `errorLogLevel?: pino.Level` | if the method errored, which level should the message be, default - `error` |
| `labeling?: Record` | add custom labeled counters using keys and values |
#### GlobalOptions
| Parameter | Description |
|:------------------------------:|-----------------------------------------------------------------------------|
| `logResult?: boolean` | log the monitored methods results |
| `logExecutionStart?: boolean` | log the start of the method's execution `method.start` |
| `parseError?: (e: any) => any` | if the method errored, transform the error that will be thrown |
| `prometheusBuckets?: number[]` | use the following prometheus bucket list for monitor metrics across methods |
| `logger?: BaseLogger` | supply a `pino` `BaseLogger` for monitor to use in logging results |
| `errorLogLevel?: pino.Level` | if the method errored, which level should the message be, default - `error` |
## License
[MIT License](LICENSE)