Send Logs to Pinghome using NLog (.NET)

This guide shows how to send logs to Pinghome from your .NET application using NLog. You'll use HTTP targets to push logs with structured context like extra, user_id, and any other fields.

🧰 Requirements

• .NET version 5 or later
• Pinghome API Token
• Log Group URL from the Pinghome Dashboard

📦 Install Packages

⚙️ Configure NLog

🚀 Log Example

✅ Sample JSON Output

{
  "logs": [
    {
      "message": "User purchased a product.",
      "level": "Info",
      "timestamp": "2025-07-23T14undefined:00.000Z",
      "user_id": "123",
      "extra": {
        "item": "Orange Soda",
        "price": 100.0
      }
    }
  ]
}

🧪 Troubleshooting

Issue	Solution
No logs in Pinghome	Check if your token and log group URL are correct.
Invalid layout or JSON	Ensure extra is serialized correctly with JsonSerializer.Serialize or proper serialization.
Nothing is sent to HTTP	Check internal-nlog.log for errors.
Config not working	Ensure NLog.config is set to CopyToOutputDirectory.

📘 See Also

• NLog Official Documentation
• Pinghome Log Groups
• Pinghome Logging Docs