[{"data":1,"prerenderedAt":646},["ShallowReactive",2],{"docs-pages-it":3,"doc-it-troubleshooting":155},[4,11,16,21,26,31,37,48,56,65,73,81,89,93,102,106,114,119,124,129,135,140,145,150],{"path":5,"title":6,"description":7,"order":8,"group":9,"parent":10,"package":10,"note":10,"collects":10,"status":10},"\u002Fdocs\u002Finstallation","Installazione","Installa CloseYourIt sul tuo server con un solo comando.",1,"start",null,{"path":12,"title":13,"description":14,"order":15,"group":9,"parent":10,"package":10,"note":10,"collects":10,"status":10},"\u002Fdocs\u002Fsettings","Impostazioni","Ogni impostazione del file .env, a cosa serve e quali non vanno mai cambiate.",2,{"path":17,"title":18,"description":19,"order":20,"group":9,"parent":10,"package":10,"note":10,"collects":10,"status":10},"\u002Fdocs\u002Fdatabase","Database","Cos'è il database, cosa contiene, quanto restano i dati e quanto spazio occupa.",3,{"path":22,"title":23,"description":24,"order":25,"group":9,"parent":10,"package":10,"note":10,"collects":10,"status":10},"\u002Fdocs\u002Fupdates-and-backups","Aggiornamenti e backup","Aggiorna a una versione nuova, fai e ripristina il backup del database, controlla l'installazione.",4,{"path":27,"title":28,"description":29,"order":30,"group":9,"parent":10,"package":10,"note":10,"collects":10,"status":10},"\u002Fdocs\u002Ftroubleshooting","Risolvere i problemi","Cosa controllare quando installazione, certificato, email o dati in arrivo non funzionano.",5,{"path":32,"title":33,"description":34,"order":35,"group":36,"parent":10,"package":10,"note":10,"collects":10,"status":10},"\u002Fdocs\u002Fconnect-your-apps","Collega le tue app","Tutti gli strumenti che mandano dati a CloseYourIt, e cosa raccoglie ognuno.",6,"connect",{"path":38,"title":39,"description":40,"order":41,"group":10,"parent":42,"package":43,"note":44,"collects":45,"status":10},"\u002Fdocs\u002Fsdk-ruby","Ruby \u002F Rails","La gemma closeyourit-ruby manda errori, log, query lente e metriche dei job da un'app Rails.",7,"connect-your-apps","closeyourit-ruby","Errori, log, query e metodi lenti, job in background.",{"errors":46,"logs":46,"performance":46,"visits":47,"servers":47},"full","none",{"path":49,"title":50,"description":51,"order":52,"group":10,"parent":42,"package":53,"note":54,"collects":55,"status":10},"\u002Fdocs\u002Fsdk-javascript","JavaScript","Il pacchetto @bussolabs\u002Fcloseyourit-js funziona nel browser e su Node 20.16 o più recente.",8,"@bussolabs\u002Fcloseyourit-js","Browser e Node, adattatori framework e query database dalla 0.13.0.",{"errors":46,"logs":46,"performance":46,"visits":46,"servers":47},{"path":57,"title":58,"description":59,"order":60,"group":10,"parent":42,"package":61,"note":62,"collects":63,"status":10},"\u002Fdocs\u002Fsdk-dart","Dart \u002F Flutter","Il pacchetto closeyourit cattura gli errori delle app Flutter, anche quando il telefono è senza rete.",9,"closeyourit","Errori, log e metriche pubblici dalla 0.9.3.",{"errors":46,"logs":64,"performance":64,"visits":47,"servers":47},"partial",{"path":66,"title":67,"description":68,"order":69,"group":10,"parent":42,"package":61,"note":70,"collects":71,"status":72},"\u002Fdocs\u002Fsdk-python","Python","Il pacchetto closeyourit manda errori, log e metriche da applicazioni Python lato server.",10,"Lato server. SQLAlchemy; query Django e FastAPI\u002FStarlette dalla 0.4.0.",{"errors":46,"logs":46,"performance":64,"visits":47,"servers":47},"pre_alpha",{"path":74,"title":75,"description":76,"order":77,"group":10,"parent":42,"package":78,"note":79,"collects":80,"status":10},"\u002Fdocs\u002Fsdk-sentry","SDK Sentry","Invia errori con un SDK Sentry compatibile; sessioni e crash hanno profili separati.",11,"Sentry SDK","Errori compatibili; sessioni e crash richiedono il profilo verificato.",{"errors":46,"logs":47,"performance":47,"visits":47,"servers":47},{"path":82,"title":83,"description":84,"order":85,"group":10,"parent":42,"package":86,"note":87,"collects":88,"status":10},"\u002Fdocs\u002Fagent-server","Agent per server","Un piccolo programma sul server che manda lo stato della macchina ogni 60 secondi.",12,"closeyourit-agent","CPU, memoria, dischi, rete, container e servizi.",{"errors":47,"logs":64,"performance":47,"visits":47,"servers":46},{"path":90,"title":91,"description":92,"order":85,"group":36,"parent":10,"package":10,"note":10,"collects":10,"status":10},"\u002Fdocs\u002Fnuxt","Vue e Nuxt","Collega gli errori del browser Nuxt e del server Nitro senza esporre un token segreto.",{"path":94,"title":95,"description":96,"order":97,"group":10,"parent":42,"package":98,"note":99,"collects":100,"status":101},"\u002Fdocs\u002Fagent-kubernetes","Kubernetes","Un osservatore in sola lettura del cluster: una copia sola per cluster.",13,"closeyourit-kube","Macchine, app ed eventi di errore del cluster.",{"errors":47,"logs":47,"performance":47,"visits":47,"servers":46},"coming",{"path":103,"title":104,"description":105,"order":97,"group":36,"parent":10,"package":10,"note":10,"collects":10,"status":10},"\u002Fdocs\u002Fopentelemetry","OpenTelemetry","Invia tracce, metriche e log dei server attraverso il ricevitore OTLP facoltativo.",{"path":107,"title":108,"description":109,"order":110,"group":10,"parent":42,"package":111,"note":112,"collects":113,"status":10},"\u002Fdocs\u002Fcli","CLI cyi","Il comando closeyourit, in breve cyi: gestisci progetti, errori e ticket dal terminale.",14,"@bussolabs\u002Fcloseyourit-cli","Non raccoglie dati: comanda CloseYourIt dal terminale.",{"errors":47,"logs":47,"performance":47,"visits":47,"servers":47},{"path":115,"title":116,"description":117,"order":118,"group":36,"parent":10,"package":10,"note":10,"collects":10,"status":10},"\u002Fdocs\u002Fhttp-api","API HTTP","Manda errori, log, metriche e visite con semplici richieste HTTP, senza un SDK.",15,{"path":120,"title":121,"description":122,"order":123,"group":36,"parent":10,"package":10,"note":10,"collects":10,"status":10},"\u002Fdocs\u002Fgithub-app","GitHub","Collega i repository GitHub a ticket e rilasci con una GitHub App tua.",16,{"path":125,"title":126,"description":127,"order":128,"group":36,"parent":10,"package":10,"note":10,"collects":10,"status":10},"\u002Fdocs\u002Fingest-gateway","Gateway di ingest","Tieni al sicuro errori, log e metriche in arrivo quando l'app è lenta o sta ripartendo.",17,{"path":130,"title":131,"description":132,"order":133,"group":134,"parent":10,"package":10,"note":10,"collects":10,"status":10},"\u002Fdocs\u002Fai","AI","Accendi assistente, analisi, dettatura e ricerca intelligente con una chiave CloseYourIt AI o con il tuo provider.",18,"automation",{"path":136,"title":137,"description":138,"order":139,"group":134,"parent":10,"package":10,"note":10,"collects":10,"status":10},"\u002Fdocs\u002Fautomator","Automator","Fai lavorare i ticket in automatico su una tua macchina Linux, con Claude Code, Codex o tutti e due.",19,{"path":141,"title":142,"description":143,"order":144,"group":36,"parent":10,"package":10,"note":10,"collects":10,"status":10},"\u002Fdocs\u002Fstack-coverage","Framework e copertura degli stack","Scegli un SDK pubblicato o verifica i limiti di un’integrazione provata localmente.",20,{"path":146,"title":147,"description":148,"order":149,"group":36,"parent":10,"package":10,"note":10,"collects":10,"status":10},"\u002Fdocs\u002Fmonitoring","Tracce, misure e sessioni","Esplora i nuovi segnali, confronta le versioni e ricostruisci le posizioni originali degli errori.",21,{"path":151,"title":152,"description":153,"order":154,"group":36,"parent":10,"package":10,"note":10,"collects":10,"status":10},"\u002Fdocs\u002Fnode-database","Database Node","Monitora query lente e ripetute con pg, mysql2, Drizzle e Prisma PostgreSQL.",22,{"id":156,"title":28,"body":157,"collects":10,"description":29,"extension":640,"group":9,"meta":641,"navigation":642,"note":10,"order":30,"package":10,"parent":10,"path":27,"seo":643,"status":10,"stem":644,"__hash__":645},"docs_it\u002Fdocs\u002Ftroubleshooting.md",{"type":158,"value":159,"toc":629},"minimark",[160,164,209,214,314,318,321,343,346,375,378,382,417,421,424,428,434,523,527,553,579,583,596,600,605,609,625],[161,162,163],"p",{},"Parti da qui, qualunque sia il problema:",[165,166,171],"pre",{"className":167,"code":168,"language":169,"meta":170,"style":170},"language-bash shiki shiki-themes github-light github-dark","closeyourit doctor     # disco, app, certificato, backup, ingest, versione\ncloseyourit status     # quali servizi sono accesi\ncloseyourit logs       # cosa dicono l'app e il worker\n","bash","",[172,173,174,189,199],"code",{"__ignoreMap":170},[175,176,178,181,185],"span",{"class":177,"line":8},"line",[175,179,61],{"class":180},"sScJk",[175,182,184],{"class":183},"sZZnC"," doctor",[175,186,188],{"class":187},"sJ8bj","     # disco, app, certificato, backup, ingest, versione\n",[175,190,191,193,196],{"class":177,"line":15},[175,192,61],{"class":180},[175,194,195],{"class":183}," status",[175,197,198],{"class":187},"     # quali servizi sono accesi\n",[175,200,201,203,206],{"class":177,"line":20},[175,202,61],{"class":180},[175,204,205],{"class":183}," logs",[175,207,208],{"class":187},"       # cosa dicono l'app e il worker\n",[210,211,213],"h2",{"id":212},"linstaller-si-ferma","L'installer si ferma",[215,216,217,230],"table",{},[218,219,220],"thead",{},[221,222,223,227],"tr",{},[224,225,226],"th",{},"Messaggio",[224,228,229],{},"Cosa fare",[231,232,233,247,264,278,291,301],"tbody",{},[221,234,235,241],{},[236,237,238],"td",{},[172,239,240],{},"run it as root (sudo bash)",[236,242,243,244],{},"lancia il comando con ",[172,245,246],{},"sudo",[221,248,249,254],{},[236,250,251],{},[172,252,253],{},"unsupported CPU",[236,255,256,257,260,261],{},"il server non è ",[172,258,259],{},"x86_64"," né ",[172,262,263],{},"arm64",[221,265,266,275],{},[236,267,268,271,272],{},[172,269,270],{},"curl is missing",", ",[172,273,274],{},"openssl is missing",[236,276,277],{},"installa il pacchetto e rilancia",[221,279,280,285],{},[236,281,282],{},[172,283,284],{},"already has an install: use 'closeyourit update'",[236,286,287,288],{},"CloseYourIt c'è già; per aggiornarlo lancia ",[172,289,290],{},"closeyourit update",[221,292,293,298],{},[236,294,295],{},[172,296,297],{},"could not read the latest version from GitHub",[236,299,300],{},"il server non raggiunge GitHub; controlla il suo accesso a internet",[221,302,303,308],{},[236,304,305],{},[172,306,307],{},"the app did not start",[236,309,310,311],{},"leggi il log: ",[172,312,313],{},"cd \u002Fopt\u002Fcloseyourit && docker compose logs app",[210,315,317],{"id":316},"lindirizzo-non-si-apre-o-il-browser-avvisa-sul-certificato","L'indirizzo non si apre, o il browser avvisa sul certificato",[161,319,320],{},"Il certificato arriva solo quando sono vere tutte queste cose:",[322,323,324,328,340],"ul",{},[325,326,327],"li",{},"il dominio punta a questo server (l'installer ti avvisa se non è così);",[325,329,330,331,335,336,339],{},"le porte ",[332,333,334],"strong",{},"80"," e ",[332,337,338],{},"443"," sono aperte, sul server e sul firewall del fornitore;",[325,341,342],{},"nient'altro sul server usa già quelle porte.",[161,344,345],{},"Sistema quello che manca, poi guarda cosa dice il web server:",[165,347,349],{"className":167,"code":348,"language":169,"meta":170,"style":170},"cd \u002Fopt\u002Fcloseyourit && docker compose logs caddy\n",[172,350,351],{"__ignoreMap":170},[175,352,353,357,360,364,367,370,372],{"class":177,"line":8},[175,354,356],{"class":355},"sj4cs","cd",[175,358,359],{"class":183}," \u002Fopt\u002Fcloseyourit",[175,361,363],{"class":362},"sVt8B"," && ",[175,365,366],{"class":180},"docker",[175,368,369],{"class":183}," compose",[175,371,205],{"class":183},[175,373,374],{"class":183}," caddy\n",[161,376,377],{},"Il certificato viene richiesto di nuovo da solo: non serve reinstallare.",[210,379,381],{"id":380},"non-arriva-nessuna-email","Non arriva nessuna email",[322,383,384,403,410],{},[325,385,386,389,390,393,394,397,398,402],{},[172,387,388],{},"SMTP_ADDRESS"," è vuoto in ",[172,391,392],{},"\u002Fopt\u002Fcloseyourit\u002F.env",": allora CloseYourIt non manda niente. Compila le impostazioni SMTP e lancia ",[172,395,396],{},"closeyourit restart",". Vedi ",[399,400,13],"a",{"href":401},"\u002Fit\u002Fdocs\u002Fsettings",".",[325,404,405,406,409],{},"Le impostazioni ci sono ma la posta non arriva: ",[172,407,408],{},"closeyourit logs"," mostra l'errore restituito dal server SMTP.",[325,411,412,413,416],{},"La posta finisce nello spam: il dominio di ",[172,414,415],{},"MAIL_FROM"," deve permettere al tuo server SMTP di spedire per lui (record SPF e DKIM presso il tuo fornitore DNS).",[210,418,420],{"id":419},"ho-perso-la-password-dellamministratore","Ho perso la password dell'amministratore",[161,422,423],{},"Usa \"Password dimenticata\" nella pagina di accesso. Serve l'email funzionante: se l'hai saltata, imposta prima l'SMTP.",[210,425,427],{"id":426},"unapplicazione-manda-dati-ma-non-si-vede-niente","Un'applicazione manda dati ma non si vede niente",[161,429,430,431,402],{},"Manda una richiesta a mano e leggi la risposta; vedi ",[399,432,116],{"href":433},"\u002Fit\u002Fdocs\u002Fhttp-api",[215,435,436,446],{},[218,437,438],{},[221,439,440,443],{},[224,441,442],{},"Risposta",[224,444,445],{},"Causa",[231,447,448,458,468,478,491,505],{},[221,449,450,455],{},[236,451,452],{},[172,453,454],{},"401",[236,456,457],{},"il token è sbagliato, revocato, oppure è la chiave pubblica usata dove serve il token segreto",[221,459,460,465],{},[236,461,462],{},[172,463,464],{},"404",[236,466,467],{},"l'id del progetto nell'indirizzo non è il progetto del token",[221,469,470,475],{},[236,471,472],{},[172,473,474],{},"422",[236,476,477],{},"il corpo non è quello che quell'indirizzo si aspetta",[221,479,480,485],{},[236,481,482],{},[172,483,484],{},"429",[236,486,487,488],{},"troppe richieste: rallenta e rispetta ",[172,489,490],{},"Retry-After",[221,492,493,502],{},[236,494,495,498,499],{},[172,496,497],{},"202"," con ",[172,500,501],{},"accepted: 0",[236,503,504],{},"la funzione è spenta per quel progetto, oppure la richiesta sembrava di un bot",[221,506,507,512],{},[236,508,509,511],{},[172,510,497],{},", ma ancora niente",[236,513,514,515,518,519,522],{},"i dati li salva il worker: controlla con ",[172,516,517],{},"closeyourit status"," che ",[172,520,521],{},"worker"," sia acceso",[210,524,526],{"id":525},"il-disco-si-riempie","Il disco si riempie",[165,528,530],{"className":167,"code":529,"language":169,"meta":170,"style":170},"df -h \u002Fopt\u002Fcloseyourit\ndocker system df\n",[172,531,532,543],{"__ignoreMap":170},[175,533,534,537,540],{"class":177,"line":8},[175,535,536],{"class":180},"df",[175,538,539],{"class":355}," -h",[175,541,542],{"class":183}," \u002Fopt\u002Fcloseyourit\n",[175,544,545,547,550],{"class":177,"line":15},[175,546,366],{"class":180},[175,548,549],{"class":183}," system",[175,551,552],{"class":183}," df\n",[322,554,555,563,573],{},[325,556,557,559,560,402],{},[332,558,18],{},": accorcia quanto restano i dati per i progetti più rumorosi. Vedi ",[399,561,18],{"href":562},"\u002Fit\u002Fdocs\u002Fdatabase",[325,564,565,568,569,572],{},[332,566,567],{},"Versioni vecchie",": ogni aggiornamento lascia indietro l'immagine precedente. ",[172,570,571],{},"docker image prune"," toglie quelle non usate.",[325,574,575,578],{},[332,576,577],{},"Coda dell'ingest",": può arrivare a 4 GB mentre l'app è spenta, e si svuota quando l'app torna.",[210,580,582],{"id":581},"un-aggiornamento-non-è-riuscito","Un aggiornamento non è riuscito",[161,584,585,586,588,589,592,593,595],{},"Se dice che la versione non è stata trovata, controlla il numero: non è cambiato niente. Altrimenti ",[172,587,290],{}," torna da solo alla versione e ai file di prima e te lo dice. Il backup fatto subito prima è in ",[172,590,591],{},"\u002Fopt\u002Fcloseyourit\u002Fbackups\u002F",". Leggi ",[172,594,408],{}," per capire perché la versione nuova non è partita, poi riprova.",[210,597,599],{"id":598},"il-paese-delle-visite-è-vuoto","Il paese delle visite è vuoto",[161,601,602,603,402],{},"Il database dei paesi non c'è. Vedi \"Paesi nelle statistiche web\" in ",[399,604,13],{"href":401},[210,606,608],{"id":607},"ancora-bloccato","Ancora bloccato",[161,610,611,612,617,618,621,622,624],{},"Apri una issue su ",[399,613,121],{"href":614,"rel":615},"https:\u002F\u002Fgithub.com\u002Fbussolabs\u002Fcloseyourit-community\u002Fissues",[616],"nofollow"," con l'output di ",[172,619,620],{},"closeyourit doctor"," e le righe utili di ",[172,623,408],{},". Togli prima token e password.",[626,627,628],"style",{},"html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html pre.shiki code .sJ8bj, html code.shiki .sJ8bj{--shiki-default:#6A737D;--shiki-dark:#6A737D}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}",{"title":170,"searchDepth":15,"depth":15,"links":630},[631,632,633,634,635,636,637,638,639],{"id":212,"depth":15,"text":213},{"id":316,"depth":15,"text":317},{"id":380,"depth":15,"text":381},{"id":419,"depth":15,"text":420},{"id":426,"depth":15,"text":427},{"id":525,"depth":15,"text":526},{"id":581,"depth":15,"text":582},{"id":598,"depth":15,"text":599},{"id":607,"depth":15,"text":608},"md",{},true,{"title":28,"description":29},"docs\u002Ftroubleshooting","6DvGcxMEnYd1w4gZBClrr5jCBzqj-O3mIKCwQcLielg",1791302513751]