Troubleshooting Guide

Encountering issues? Here are some common problems and how to resolve them.

Login & Connection Issues

• Problem: Invalid Canvas Token.

  • Solution:
    1. Ensure you copied the entire token correctly from Canvas.
    2. The token might have expired if you set an expiration date. Generate a new one in Canvas (see Setup Guide).
    3. The Canvas URL hardcoded in Vite (isd271.instructure.com) must match your institution's Canvas URL. If it's different, this application version won't work for you without code changes.

• Problem: Invalid Duolingo Token.

  • Solution:
    1. Ensure you copied the correct jwt_token value from your browser's developer tools while logged into Duolingo for Schools.
    2. This token can expire or become invalid if you log out of Duolingo, clear browser cookies, or after a certain period. Try getting a fresh token (see Setup Guide).

• Problem: Vite says I'm connected, but my name doesn't appear.

  • Solution: This could be a minor glitch in fetching user details immediately after connection. Try navigating to another page in Vite and back, or refresh. If the issue persists, re-verify your tokens.

Data Not Appearing (Courses, Students, XP)

• Problem: My Canvas courses aren't showing up in Vite.

  • Solution:
    1. Ensure your Canvas token is valid and you're connected.
    2. Vite typically fetches "active" courses. Check the enrollment state of your course in Canvas.
    3. There might be a temporary API issue with Canvas. Try again later.

• Problem: My Duolingo classrooms aren't showing up.

  • Solution:
    1. Ensure your Duolingo token is valid and you're connected.
    2. Make sure you are using Duolingo for Schools and have classrooms set up there.
    3. Temporary API issue with Duolingo. Try again later.

• Problem: Students are missing from the list when trying to match.

  • Canvas Students: Ensure students are correctly enrolled in the Canvas course and their enrollment is active.
  • Duolingo Students: Ensure students have joined your Duolingo classroom using the correct classroom code or link. They must also have some activity for their names to populate in some API views.

• Problem: Duolingo XP is showing as 0 or not updating.

  • Solution:
    1. Double-check the selected Grading Period or date range in Vite. XP is fetched only for the specified timeframe.
    2. Ensure students are correctly matched between Canvas and Duolingo.
    3. Students must have actually completed activities in Duolingo within the selected date range.
    4. Duolingo's API might have a slight delay in reporting the very latest XP.
    5. Check if you have any "Skipped XP Entries" configured in Settings that might be affecting the student's total for that period.

Grade Calculation & Anomaly Errors

• Problem: Grades are not calculating as expected.

  • Solution:
    1. Verify the XP Goal set for the specific Course Match.
    2. Check your Settings: Max Base Grade, Max Extra Credit Grade, and grading equation.
    3. Ensure the Duolingo XP data for the period is accurate.
    4. Check if any "Skipped XP Entries" or "Ignored Anomalies" are unintentionally affecting calculations.

• Problem: Too many students are being flagged by Anomaly Detection.

  • Solution: The default thresholds for anomaly detection might be too sensitive for your class. While not directly configurable in the UI, be aware that factors like very short, focused Duolingo sessions could sometimes trigger flags. Use your judgment when reviewing. If a student is consistently flagged despite legitimate work, you can add their individual detections to the "Ignored Anomalies" list in Settings.

• Problem: "Infinite Rate" or "High XP with zero time" messages.

  • Solution: This usually indicates a minor inaccuracy in the XP data fetched from Duolingo, though it can also be a sign of a student using exploits to gain XP. Check the student's activity using the Investigate button in the Anomaly Report. If you believe the XP is legitimate, you can use the Ignore button to prevent future flags for that specific instance. If you believe the XP is illegitimate, consider using the Invalidate button to remove that XP from the student's total for that period.

Canvas Grade Push Failures

• Problem: Grades are not appearing in Canvas after pushing.

  • Solution:
    1. Check the Canvas Assignment:
       • Ensure the assignment exists in Canvas and is published.
       • Ensure the assignment is not in a muted state in Canvas.
       • The "Points Possible" for the Canvas assignment should ideally align with the total possible points from Vite (Max Base Grade + Max Extra Credit Grade).
    2. Progress Monitoring: Vite should show the status of the grade push job (e.g., "completed", "failed"). If it failed, there might be an error message.
    3. Canvas API Issues: Occasionally, Canvas might be slow or experience temporary API issues. Try pushing again after some time.
    4. Token Permissions/Expiry: Your Canvas token might have expired or lack necessary permissions (though generation usually grants full permissions).

• Problem: "Rate Limit Exceeded" error when pushing grades.

  • Solution: You've made too many requests to the Canvas API in a short period. Wait for a few minutes and try again.
  • If you frequently encounter this error, please contact the developer to alert them of the issue.

Understanding Statuses

• "Needs Review" / "Incomplete" for Matched Courses:
  • This means Vite has a record of a match, but it couldn't find the actual course on Canvas or the classroom on Duolingo (or both) when it last checked.
  • Possible Causes:
    • The course/classroom was deleted or archived on Canvas/Duolingo.
    • The ID stored in Vite for the match is incorrect.
    • Temporary API error when fetching course/classroom lists.
  • Action: Verify the course/classroom still exists. You may need to unmatch and rematch it in Vite.

General Tips

• Refresh Tokens: If you consistently have issues, try getting fresh API tokens for both Canvas and Duolingo.
• Check Console Logs: If you're comfortable, your browser's Developer Tools (Console tab) might show more detailed error messages from the application.
• Patience: Sometimes, API responses can be slow, or background jobs (like grade pushing) take time. Give the system a few moments before assuming an error.

If problems persist, please document the steps you took, any error messages you saw, and reach out for further assistance if a support channel is available.