Skip to content

Commit 4aafa14

Browse files
committed
Update dynamodb-cache-extension.md
1 parent 8665750 commit 4aafa14

File tree

1 file changed

+11
-2
lines changed

1 file changed

+11
-2
lines changed

docs/recipes/dynamodb-cache-extension.md

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -660,6 +660,7 @@ this.caches = {
660660
```
661661

662662
2. **Check Cache Metrics**: Use `cacheGetMetadata()` to analyze usage patterns
663+
663664
```javascript
664665
var metadata = cacheGetMetadata(id="popular_item", cacheName="dynamodb");
665666
if(metadata.hitCount > 1000) {
@@ -690,6 +691,7 @@ this.caches = {
690691
4. **Enable CloudTrail logging** for audit trails
691692

692693
### Recommended IAM Policy
694+
693695
```json
694696
{
695697
"Version": "2012-10-17",
@@ -730,38 +732,44 @@ this.caches = {
730732
### Common Issues
731733

732734
#### Connection Errors
735+
733736
```
734737
Error: Unable to connect to DynamoDB
735738
```
736739

737740
**Solution**: Verify your credentials and region settings. Check if the host parameter is set correctly for DynamoDB Local.
738741

739742
#### Table Not Found
743+
740744
```
741745
Error: ResourceNotFoundException: Cannot do operations on a non-existent table
742746
```
743747

744748
**Solution**: The extension automatically creates tables. If this error occurs, verify the IAM permissions include `CreateTable` action.
745749

746750
#### Throttling
751+
747752
```
748753
Error: ProvisionedThroughputExceededException
749754
```
750755

751756
**Solution**: For production tables, consider switching to on-demand billing mode or increasing provisioned capacity.
752757

753758
#### Invalid Security Token
759+
754760
```
755761
Error: The security token included in the request is invalid
756762
```
757763

758-
**Solution**:
764+
**Solution**:
765+
759766
- For AWS: Verify your credentials are correct and not expired
760767
- For DynamoDB Local: Ensure the host parameter is set to `http://localhost:8000`
761768

762769
### Debug Logging
763770

764771
Enable detailed logging to troubleshoot issues:
772+
765773
```javascript
766774
custom: {
767775
"log": "dynamodb-debug",
@@ -774,6 +782,7 @@ Then check your Lucee logs at: `[lucee-config]/logs/dynamodb-debug.log`
774782
## Migration from Other Cache Providers
775783

776784
### From EhCache
785+
777786
```javascript
778787
// Old EhCache configuration
779788
this.cache.connections["ehcache"] = {
@@ -832,6 +841,6 @@ Unlike older OSGi-based extensions, the DynamoDB extension leverages Lucee 7's M
832841
## Support and Contribution
833842

834843
- **GitHub**: [lucee/extension-dynamodb](https://github.com/lucee/extension-dynamodb)
835-
- **Issues**: Report bugs or request features on [ Jira](https://issues.lucee.org/)
844+
- **Issues**: Report bugs or request features on [Jira](https://issues.lucee.org/)
836845
- **Community**: Join the Lucee community forums for support
837846
- **Extensions**: Visit the Lucee [Download](https://download.lucee.org/) page for updates

0 commit comments

Comments
 (0)