gamma-performance-tuning

Gamma Performance Tuning

Contents

• Overview
• Prerequisites
• Instructions
• Output
• Error Handling
• Examples
• Resources

Overview

Optimize Gamma API integration performance through client configuration, caching, connection pooling, and parallel request patterns.

Prerequisites

• Working Gamma integration
• Performance monitoring tools
• Understanding of caching concepts

Instructions

Step 1: Optimize Client Configuration

Enable keep-alive, compression, and configure max sockets (10). Set retry conditions for 5xx and 429 errors.

Step 2: Implement Response Caching

Use node-cache with 5-minute TTL. Invalidate on presentation.updated events.

Step 3: Parallelize Requests

Replace sequential loops with p-limit (concurrency 5) for bulk operations. Use batch API where available.

Step 4: Add Pagination with Generators

Use async generators for memory-efficient iteration over large presentation lists.

Step 5: Optimize Request Payloads

Request only needed fields to reduce response size. Use returnImmediately for creation operations.

Step 6: Configure Connection Pooling

Create shared HTTP/HTTPS agents with keep-alive, 25 max sockets, and 60s timeout.

See detailed implementation for advanced patterns.

Output

• Optimized client configuration
• Response caching layer
• Parallel request patterns
• Connection pooling setup
• Performance monitoring

Error Handling

Issue	Cause	Solution
High latency	No connection reuse	Enable keep-alive and pooling
Memory growth	Unbounded cache	Set TTL and max cache size
Rate limiting	Too many parallel requests	Use p-limit with concurrency cap

Examples

Performance Targets

Operation	Target	Action if Exceeded
Simple GET	< 200ms	Check network, use caching
List (100 items)	< 500ms	Reduce page size
Create presentation	< 5s	Use async pattern
Export PDF	< 30s	Use webhook notification

Resources

• Gamma Performance Guide
• Node.js Performance