KyotoTechLogger 1.2.2

KyotoTech Logger

Zero-dependency, cross-platform logging library for .NET 8+

Overview

KyotoTech Logger is a production-ready logging library that ships as a single DLL with zero external dependencies. All required libraries are embedded, ensuring hassle-free integration into any .NET 8+ project.

Key Features

• Zero Dependencies - Single DLL deployment with all libraries embedded
• Cross-Platform - Windows, macOS, Linux, iOS, and Android
• Thread-Safe - Singleton pattern with LogService.Instance
• 150+ Log Types - Comprehensive categorization for all application layers
• Local + Remote Logging - File-based storage with server upload capability
• License Tiers - Free, Developer, Professional, and Enterprise
• Async Operations - Non-blocking I/O for optimal performance
• Graceful Degradation - Never crashes your application

Installation

dotnet add package KyotoTechLogger

Or via NuGet Package Manager:

Install-Package KyotoTechLogger

Quick Start

Initialization

Initialize once at application startup with your License Key, API Key, and server URL:

using KyotoTechLogger;
using KyotoTechLogger.Models;
using System.Reflection;

// Synchronous initialization
var result = LogService.Initialize(
    licenseKey: "YOUR-LICENSE-KEY",
    apiKey: "ktlog_production_your_key_here",
    serverUrl: "https://logger.kyototech.co.jp/api/v1/logs");

if (!result.Success)
{
    Console.WriteLine($"Init failed: {result.ErrorMessage}");
    return;
}

// Async initialization (ASP.NET Core, MAUI)
var result = await LogService.InitializeAsync(
    licenseKey: "YOUR-LICENSE-KEY",
    apiKey: "ktlog_production_your_key_here",
    serverUrl: "https://logger.kyototech.co.jp/api/v1/logs");

// From license file (offline activation)
var result = LogService.InitializeWithFile(
    licensePath: "path/to/license.lic",
    apiKey: "ktlog_production_your_key_here",
    serverUrl: "https://logger.kyototech.co.jp/api/v1/logs");

License Key = Delivered with your subscription (format: TIER-XXXX-XXXX-XXXX-XXXX) API Key = Created by you on the dashboard under Project Settings (format: ktlog_production_...)

Logging

// Log a message
LogService.Instance.Log(
    MethodBase.GetCurrentMethod(),
    "User login successful",
    LogTypes.AuthLog);

// Log an exception
try
{
    // Your code
}
catch (Exception ex)
{
    LogService.Instance.Log(
        MethodBase.GetCurrentMethod(),
        ex,
        LogTypes.ErrorLog);
}

// Log with custom metadata (v1.2.0+)
LogService.Instance.Log(
    MethodBase.GetCurrentMethod(),
    "Order completed",
    LogTypes.BusinessLog,
    new Dictionary<string, object>
    {
        ["orderId"] = "ORD-12345",
        ["customerId"] = "CUST-789",
        ["amount"] = 99.99,
        ["items"] = new[] { "SKU-001", "SKU-002" }
    });

Configuration Options

Pass an options callback during initialization:

var result = LogService.Initialize(licenseKey, apiKey, serverUrl, opts =>
{
    opts.ShowConsole = true;          // Print logs to console
    opts.ShowConsoleDebug = true;     // Print to debug output
    opts.TimeoutSeconds = 15;         // HTTP timeout for uploads
    opts.MaxLogAgeDays = 30;          // Local log retention
    opts.RemoteLogTypes = new List<LogTypes>  // Only upload these types
    {
        LogTypes.ErrorLog,
        LogTypes.CrashLog,
        LogTypes.SecurityLog
    };
});

Runtime configuration changes:

LogService.Instance.SetApiKey("ktlog_production_new_key");
LogService.Instance.ToggleShowConsole(true);
LogService.Instance.SetRemoteLogTypesAllowToSend(new List<LogTypes> { LogTypes.ErrorLog });
LogService.Instance.SetMaxLogsAge(14);
LogService.Instance.SetDefaultServerUrl("https://logger.kyototech.co.jp/api/v1/logs", 30);

Remote Log Upload

// Upload all pending logs
var uploadResult = await LogService.Instance.UploadLogsAsync();

// Upload specific log types only
await LogService.Instance.UploadLogsAsync(new List<LogTypes>
{
    LogTypes.ErrorLog,
    LogTypes.SecurityLog
});

// Upload previously failed logs
await LogService.Instance.UploadBackupFilesAsync();

// Clean up old local log files
await LogService.Instance.RemoveAllOldLogFilesAsync();

API Reference

Logging

Initialization

Runtime Configuration

Remote Operations

Log Types

KyotoTech Logger includes 150+ predefined log types covering:

Platform Support

License Tiers

Visit kyototech.co.jp/pricing for details. Create your free account at logger.kyototech.co.jp.

File Storage

Local Logs

~/Documents/Logs/
├── log_error.txt
├── log_auth.txt
├── log_performance.txt
└── ...

Local log files automatically rotate at 1 MB.

Remote Logs (JSON)

~/Documents/LogsRemote/
├── log_error.json
├── log_error_backup.json
└── ...

Remote log files are stored locally until successfully uploaded to your server.

Requirements

• .NET 8.0 or later
• No additional NuGet packages required
• Works without license key (Free tier: 50 logs/day)

Support

• Email: support@kyototech.co.jp
• Website: kyototech.co.jp

Legal

Copyright (c) 2024-2026 KyotoTech LLC. All rights reserved.

This software is licensed under the KyotoTech Software License Agreement. See the LICENSE file for the complete license terms.

Use of this software is subject to the acceptance of the license agreement. Unauthorized copying, modification, distribution, or use of this software is strictly prohibited and may result in severe civil and criminal penalties.