Troubleshooting AWS Log Files in IronPDF

January 19, 2022

Updated June 1, 2025

Isolating IronPDF Logs Using S3 Bucket

When troubleshooting issues with IronPDF in an AWS environment, obtaining clean, dedicated logs from the IronPDF library itself is highly beneficial. This approach helps avoid the complexities of sifting through merged log streams from services like Amazon CloudWatch Logs or AWS Application Insights.

Services like CloudWatch Logs and Application Insights typically aggregate logs from various sources, including your application code, other libraries, and AWS services. This interleaving can make it difficult to pinpoint IronPDF-specific messages and diagnose issues related to PDF generation or manipulation directly.

To overcome these challenges, we recommend configuring IronPDF to write its logs to a dedicated file within your AWS compute environment's temporary storage. This isolated log file can then be easily uploaded to an Amazon S3 bucket for convenient download, review, and sharing with support if needed.

Enable and Configure IronPDF Logging

var awsTmpPath = @"/tmp/";

IronSoftware.Logger.LoggingMode = IronSoftware.Logger.LoggingModes.All;
IronSoftware.Logger.LogFilePath = awsTmpPath + "default.txt";

var awsTmpPath = @"/tmp/";

IronSoftware.Logger.LoggingMode = IronSoftware.Logger.LoggingModes.All;
IronSoftware.Logger.LogFilePath = awsTmpPath + "default.txt";

$vbLabelText $csharpLabel

Upload the Log File to an Amazon S3 Bucket

// File path in the Lambda /tmp directory
var filePath = $"/tmp/default.txt";

// Read the file as byte array
var fileBytes = await File.ReadAllBytesAsync(filePath);

// Upload the text file to S3
using (var memoryStream = new MemoryStream(fileBytes))
{
    var request = new PutObjectRequest
    {
        BucketName = bucketName,
        Key = "default.txt",
        InputStream = memoryStream,
        ContentType = "text/plain",
    };

    await _s3Client.PutObjectAsync(request);
}

// File path in the Lambda /tmp directory
var filePath = $"/tmp/default.txt";

// Read the file as byte array
var fileBytes = await File.ReadAllBytesAsync(filePath);

// Upload the text file to S3
using (var memoryStream = new MemoryStream(fileBytes))
{
    var request = new PutObjectRequest
    {
        BucketName = bucketName,
        Key = "default.txt",
        InputStream = memoryStream,
        ContentType = "text/plain",
    };

    await _s3Client.PutObjectAsync(request);
}

$vbLabelText $csharpLabel

For AWS specific logging services, please refer to the following documentation: