diff --git a/content/en/cloud/academy/extending-the-academy/index.md b/content/en/cloud/academy/extending-the-academy/index.md index a72219427..657b5f3db 100644 --- a/content/en/cloud/academy/extending-the-academy/index.md +++ b/content/en/cloud/academy/extending-the-academy/index.md @@ -48,3 +48,36 @@ For example, a Learning Path titled "Mastering Kubernetes" might contain: {{< alert type="warning" title="Content Isolation" >}} To ensure security and isolation, all of your content files must be placed within a directory named for your organization UUID. You'll learn the specifics of how to do this in our [hands-on tutorial](/cloud/academy/creating-your-learning-path/). {{< /alert >}} + +### Debugging Content Uploads Using Events + +If your content is not appearing in the Academy after a GitHub release, it may have failed to publish. You can troubleshoot these issues using the **Events** section in [Layer5 Cloud](https://cloud.layer5.io). + +To view publishing logs: + +1. Navigate to **Settings > Events** +2. Switch to the **Audit** tab +3. Apply a filter using the action type: +`AcademyUpserted` +This will show all attempts to upload content, including which ones failed and why. + +**Common Errors You Might See** +- **Duplicate IDs** +Two lessons or paths using the same identifier. You can fix this by renaming or regenerating unique IDs. + +- **Invalid Content Type** +For example, +Instead of +```yaml +type: "learning-paths" +``` +it should be: +```yaml +type: "learning-path" +``` +- **Missing Required Fields** +Ensure that title, description, and type are included in the content’s frontmatter. + +{{< alert type="info" title="Tip" >}} +Use the event filter `AcademyRegisteredToContent` to track user activity, like who enrolled in which learning path. +{{< /alert >}} \ No newline at end of file