Document Details
How To Collect Device Logs
❌
This page contains Windows bias
About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Bias Types:
⚠️
windows_first
⚠️
powershell_heavy
⚠️
windows_tools
Summary:
The documentation shows some Windows bias, particularly in the .NET/C# section, where Windows (ETW and PowerShell scripts) is described first and in more detail, with Linux instructions following. The Windows approach uses specialized tools (ETW, PowerShell scripts), while the Linux approach uses a more generic tool (dotnet-trace). There is also a slight bias in the Java example, where the log file path uses a Windows-style path (c/temp/logs) without a Linux alternative.
Recommendations:
- Present Linux and Windows instructions in parallel or in a consistent order (e.g., alphabetical or by usage share), rather than always listing Windows first.
- Ensure that Linux tooling is described with equal detail and prominence as Windows tools (e.g., provide troubleshooting tips, links, and context for dotnet-trace similar to ETW).
- Avoid using Windows-centric paths (e.g., 'c/temp/logs') in cross-platform examples; instead, provide both Windows and Linux path examples or use neutral paths.
- Where possible, mention cross-platform tools and approaches before platform-specific ones.
- If PowerShell scripts are provided for Windows, consider providing equivalent Bash scripts for Linux where feasible.
Create pull request
Scan History
| Date | Scan ID | Status | Bias Status |
|---|---|---|---|
| 2025-08-17 00:01 | #83 | in_progress | ✅ Clean |
| 2025-07-13 21:37 | #48 | completed | ❌ Biased |
| 2025-07-12 23:44 | #41 | in_progress | ❌ Biased |
| 2025-07-09 13:09 | #3 | cancelled | ✅ Clean |
| 2025-07-08 04:23 | #2 | cancelled | ❌ Biased |
Flagged Code Snippets
status = error
name = Log4j2PropertiesConfig
# Log file location - choose a suitable path for your OS
property.filePath = c/temp/logs
appenders = console,file
appender.console.type = Console
appender.console.name = LogToConsole
appender.console.layout.type = PatternLayout
appender.console.layout.pattern = %d %p (%t) [%c] - %m%n
appender.file.type = File
appender.file.name = LogToFile
appender.file.fileName = ${filePath}/device.log
appender.file.layout.type = PatternLayout
appender.file.layout.pattern = %d %p (%t) [%c] - %m%n
loggers.file
logger.file.name = com.microsoft.azure.sdk.iot
logger.file.level = debug
logger.file.appenderRefs = logfile
logger.file.appenderRef.logfile.ref = LogToFile
rootLogger.level = debug
rootLogger.appenderRefs = stdout
rootLogger.appenderRef.stdout.ref = LogToConsole