> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Samlingen Project History Failures

`projectHistoryFailures` innehåller ett dokument per projekt vars historikuppdateringar project-history inte kunde bearbeta, eller för vilket den startade en omsynkronisering. Dokumentet tas bort igen så snart bearbetningen fungerar. project-history skriver den i `services/project-history/app/js/ErrorRecorder.js`; dess typ finns i `services/project-history/app/js/mongo-types.ts:3-24`. Web har också ett Mongoose-schema för den (`services/web/app/src/models/ProjectHistoryFailure.mjs:5-19`), men ingen web-kod använder den modellen.

#### Fält

| Fält | Typ | Betydelse | Källa |
| - | - | - | - |
| `_id` | ObjectId | Skapas av upserten. | `ErrorRecorder.js:45-60` |
| `project_id` | String | Projekt-id:t, lagrat som en sträng, inte som ObjectId. | `ErrorRecorder.js:46`, `mongo-types.ts:5` |
| `error` | String | Det senaste felet, som `error.toString()`. | `ErrorRecorder.js:37` |
| `stack` | String | Stack för det senaste felet. | `ErrorRecorder.js:38` |
| `queueSize` | Number | Uppdateringar som väntade i projektets Redis-kö vid det senaste felet (`services/project-history/app/js/UpdatesProcessor.js:375`); `-1` när felet kom från start av en omsynkronisering (`services/project-history/app/js/SyncManager.js:75`, `96`). | `ErrorRecorder.js:36` |
| `ts` | Date | Tidpunkt för det senaste felet. | `ErrorRecorder.js:39` |
| `attempts` | Number | Antal fel som registrerats sedan dokumentet skapades. | `ErrorRecorder.js:49` |
| `history` | Array of Object | De senaste 10 händelserna, nyaste först: felposter `{ queueSize, error, stack, ts }` och omsynkroniseringsstarter `{ resyncStartedAt }`. | `ErrorRecorder.js:50-56`, `92-98` |
| `resyncStartedAt` | Date | När den senaste omsynkroniseringen startade. | `ErrorRecorder.js:90` |
| `resyncAttempts` | Number | Antal omsynkroniseringar som startats sedan dokumentet skapades. | `ErrorRecorder.js:91` |
| `forceDebug` | Boolean | Sätts av project-history `POST /project/:project_id/force` (`?clear=true` sätter det till `false`). Medan `true` loggas och ignoreras ett ops-out-of-order-fel i den lagrade chunken (`UpdatesProcessor.js:574-592`). | `ErrorRecorder.js:72-82` |
| `requestCount` | Number | I web-schemat (`ProjectHistoryFailure.mjs:16`). Bara `ErrorRecorder.getLastFailure` ökar det, och inget anropar den funktionen. | `ErrorRecorder.js:131-138` |

#### Vem skriver

| Kod | Vad den gör |
| - | - |
| `services/project-history/app/js/ErrorRecorder.js:34-66` | `record`: upsert av felet, `attempts` +1, post tillagd i `history`. Anropas när bearbetningen av ett projekts uppdateringar misslyckas (`UpdatesProcessor.js:91`, `169`, `242`, `293`, `345`) och när en omsynkronisering inte kan starta (`SyncManager.js:75`, `96`). |
| `ErrorRecorder.js:86-102` | `recordSyncStart`: upsert, `resyncStartedAt`, `resyncAttempts` +1, post tillagd i `history`, varje gång en omsynkronisering startar (`SyncManager.js:104`). |
| `ErrorRecorder.js:68-70` | `clearError`: tar bort dokumentet efter en lyckad flush (`UpdatesProcessor.js:101`, `194`, `259`, `355`), vid project-history `DELETE /project/:project_id` (`services/project-history/app/js/HttpController.js:1386`) och för ett felaktigt projekt-id under ett nytt försök (`services/project-history/app/js/RetryManager.js:161`). |
| `ErrorRecorder.js:72-82` | `setForceDebug`: upsert av `forceDebug` (`HttpController.js:1016-1035`, route vid `services/project-history/app/js/Router.js:82`). |
| `ErrorRecorder.js:109-119` | `cloneFailure`: kopierar dokumentet till ett annat projekt, för project-history `POST /project/:project_id/clone` (`HttpController.js:135`), som inget i web anropar. |

#### Vem läser

| Kod | Vad den gör |
| - | - |
| `RetryManager.js:113-126` | Läser in alla fel för cron-jobben för nya försök (`server-ce/config/crontab-history`, project-history `POST /retry/failures`). Soft-jobbet bearbetar kön igen; hard-jobbet omsynkroniserar projektet, som en hard-omsynkronisering när `resyncAttempts` är minst 1 och felet inte är en pågående omsynkronisering (`RetryManager.js:30-31`, `35-56`, `106-111`). |
| `services/project-history/app/js/FlushManager.js:73-82` | Flush av alla projekt hoppar över projekt som har ett fel. |
| `UpdatesProcessor.js:578-592` | Läser `forceDebug`. |
| `ErrorRecorder.js:124-129`, `140-145` | `getFailureRecord` och `getFailedProjects`: används av `GET /project/:project_id/debug-info` (`HttpController.js:571`) och `GET /status/failures`, `GET /status/failures-full` (`Router.js:88-90`). |

#### Index

| Namn | Nycklar | Alternativ | Migrering |
| - | - | - | - |
| `project_id_1` | `{ project_id: 1 }` | | `tools/migrations/20190912145018_create_projectHistoryFailures_indexes.mjs` |

#### Anteckningar

* Ett dokument ligger kvar tills en flush av projektet lyckas eller projektet tas bort (`clearError` ovan), så varje dokument markerar ett projekt vars senaste flush eller omsynkronisering ännu inte har lyckats.
* Felsträngar som börjar med `OError:` returneras som `Error:` (`ErrorRecorder.js:18-26`); det lagrade värdet ändras inte.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.