Skip to main content
outfitter-logging Patterns for @outfitter/logging including structured logging, sinks, redaction, and child loggers. Use when configuring logging, adding redaction, creating sinks, or when "logger", "structured logging", "redaction", "log level", or "@outfitter/logging" are mentioned.
الانتقال إلى التثبيت سوق المهارات اكتشف واستكشف مهارات الذكاء الاصطناعي التي بناها المجتمع.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
عرض تفاصيل Prompt يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/outfitter-dev/outfitter --skill outfitter-loggingيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
تحميل Zip جاري التحميل... المزيد من هذا المستودع Patterns for @outfitter/daemon including lifecycle management, IPC communication, health checks, and PID files. Use when building background services, daemons, or when "daemon", "IPC", "health check", "background service", or "@outfitter/daemon" are mentioned.
Creates handlers, CLI commands, MCP tools, and daemon services following Outfitter Dev Kit conventions. Use when adding new components to a project, scaffolding code, or when "create handler", "new command", "add tool", or "daemon service" are mentioned.
Deep patterns for @outfitter/mcp including tool registration, Zod schemas, resources, and server configuration. Use when building MCP servers, registering tools, defining resources, or when "MCP server", "MCP tool", "registerTool", or "@outfitter/mcp" are mentioned.
name outfitter-logging version 0.1.0 description Patterns for @outfitter/logging including structured logging, sinks, redaction, and child loggers. Use when configuring logging, adding redaction, creating sinks, or when "logger", "structured logging", "redaction", "log level", or "@outfitter/logging" are mentioned. allowed-tools Read Write Edit Glob Grep
Logging Patterns
Deep dive into @outfitter/logging patterns.
Creating a Logger
import { createLogger, createConsoleSink } from "@outfitter/logging" ;
const logger = createLogger ({
name : "my-app" ,
level : "info" ,
sinks : [createConsoleSink ()],
redaction : { enabled : true },
});
Log Levels
debuglogger.debug()Development debugging
infologger.info()Normal operations
warnlogger.warn()Unexpected but handled
errorlogger.error()Failures requiring attention
fatallogger.fatal()Unrecoverable failures
Level hierarchy: trace < debug < info < warn < error < fatal
Setting level to info hides trace and debug.
Structured Logging Always use metadata objects:
logger.info ("User created" , {
userId : user.id ,
email : user.email ,
duration : performance.now () - start,
});
logger.info ("User " + user.name + " created in " + duration + "ms" );
Child Loggers Add context that persists across calls:
import { createChildLogger } from "@outfitter/logging" ;
const requestLogger = createChildLogger (logger, {
requestId : ctx.requestId ,
handler : "createUser" ,
});
requestLogger.info ("Processing" );
requestLogger.debug ("Validated input" );
requestLogger.info ("User created" , { userId });
Redaction
Enable Redaction const logger = createLogger ({
name : "my-app" ,
level : "info" ,
sinks : [createConsoleSink ()],
redaction : { enabled : true },
});
logger.info ("Config" , {
apiKey : "secret-123" ,
password : "hunter2" ,
email : "user@example.com" ,
});
Default Redaction Patterns
password, pwdapiKey, api_keysecret, secretKeytoken, accessTokenauth, authorizationkey (when containing sensitive data)credential, credentials
Custom Patterns const logger = createLogger ({
name : "my-app" ,
redaction : {
enabled : true ,
patterns : ["password" , "apiKey" , "myCustomSecret" , "internalToken" ],
},
});
Deep Redaction Nested values are also redacted:
logger.info ("Request" , {
headers : {
authorization : "Bearer token" ,
},
body : {
user : {
password : "secret" ,
},
},
});
Sinks
Console Sink import { createConsoleSink } from "@outfitter/logging" ;
const consoleSink = createConsoleSink ({
colorize : true ,
prettyPrint : true ,
timestampFormat : "iso" ,
});
File Sink import { createFileSink } from "@outfitter/logging" ;
const fileSink = createFileSink ({
path : "/var/log/myapp/app.log" ,
maxSize : 10 * 1024 * 1024 ,
maxFiles : 5 ,
});
Multiple Sinks const logger = createLogger ({
name : "my-app" ,
level : "debug" ,
sinks : [
createConsoleSink ({ level : "info" }),
createFileSink ({
path : "/var/log/myapp/debug.log" ,
level : "debug" ,
}),
],
});
Custom Sink const customSink = {
log : (record ) => {
externalService.send ({
level : record.level ,
message : record.message ,
metadata : record.metadata ,
timestamp : record.timestamp ,
});
},
};
const logger = createLogger ({
name : "my-app" ,
sinks : [customSink],
});
Environment Configuration const logger = createLogger ({
name : "my-app" ,
level : process.env .LOG_LEVEL || "info" ,
sinks : [
createConsoleSink ({
colorize : process.stdout .isTTY ,
prettyPrint : process.env .NODE_ENV !== "production" ,
}),
],
});
Handler Context Integration import { createContext } from "@outfitter/contracts" ;
import { createLogger, createChildLogger } from "@outfitter/logging" ;
const baseLogger = createLogger ({ name : "my-app" , level : "info" });
export function createHandlerContext (const ctx = createContext ({ logger : baseLogger });
return {
...ctx,
logger : createChildLogger (baseLogger, { requestId : ctx.requestId }),
};
}
const myHandler : Handler <Input , Output , Error > = async (input, ctx) => {
ctx.logger .info ("Processing" , { input });
};
Performance
Conditional Logging
if (logger.isEnabled ("debug" )) {
const expensiveData = computeDebugInfo ();
logger.debug ("Debug info" , { data : expensiveData });
}
Lazy Evaluation logger.debug ("State" , () => ({
memory : process.memoryUsage (),
connections : getActiveConnections (),
}));
Best Practices
Structured metadata — Always use objects, not string concatenationChild loggers — Add request context that persistsEnable redaction — Prevent secrets from leakingLevel per environment — Debug in dev, info in prodRequest IDs — Include for tracing across handlersLazy evaluation — Avoid expensive computations at disabled levels
Related Skills
stack:patterns — Context creationstack:outfitter-daemon — Daemon loggingstack:debug — Troubleshooting logging المهن ذات الصلة SOC
استنادا إلى تصنيف SOC المهني
