Troubleshooting Common Issues

This section provides solutions and guidance for resolving common problems encountered when using make87.

Deployment Issues

Application Not Starting

• Cause: Incorrect manifest configuration or resource constraints.
• Solution: Verify your MAKE87.yml manifest fields and resource limits. Use logs available in the make87 dashboard to identify the exact failure.

Rollback Failures

• Cause: Incompatible configurations between releases.
• Solution: Ensure compatibility of interfaces and resources before rollback. Check release notes and configurations differences.

Networking Issues

Applications Not Communicating

• Cause: Misconfigured interfaces or unsupported protocol.
• Solution: Double-check interface definitions and protocols in your manifest. Confirm endpoint details in MAKE87_CONFIG.

High Network Latency

• Cause: Suboptimal application placement or overloaded network.
• Solution: Optimize application placement (edge/cloud), verify overlay network status via make87 dashboard, and adjust as necessary.

Logging and Monitoring

Logs Not Captured

• Cause: Application not emitting logs to stdout/stderr or incorrect Vector configuration.
• Solution: Verify your application's logging configuration. Ensure Vector is properly configured to collect and forward logs.

Missing Metrics

• Cause: Misconfigured metrics exposure.
• Solution: Confirm metrics endpoints are correctly exposed and reachable. Verify your monitoring setup and adjust protocols as needed.

Resource Management

Resource Limits Not Honored

• Cause: Incorrect or missing resource specifications.
• Solution: Explicitly specify CPU and memory constraints in your manifests. Monitor resource usage and adjust limits.

Security and Permissions

Secrets Unavailable

• Cause: Misconfigured secret references or vault issues.
• Solution: Verify secrets are properly referenced in MAKE87.yml and mounted at runtime. Check secret accessibility via the path specified in MAKE87_CONFIG.

Permission Denied Errors

• Cause: Incorrect or insufficient permissions.
• Solution: Review and adjust access rules via the make87 permissions interface. Follow the principle of least privilege.