[{"data":1,"prerenderedAt":362},["ShallowReactive",2],{"docs-pages-it":3,"doc-it-sdk-ruby":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":39,"body":157,"collects":355,"description":40,"extension":356,"group":10,"meta":357,"navigation":358,"note":44,"order":41,"package":43,"parent":42,"path":38,"seo":359,"status":10,"stem":360,"__hash__":361},"docs_it\u002Fdocs\u002Fsdk-ruby.md",{"type":158,"value":159,"toc":348},"minimark",[160,165,169,215,218,233,241,245,266,270,310,313,317,332,336,344],[161,162,164],"h2",{"id":163},"cosa-raccoglie","Cosa raccoglie",[166,167,168],"p",{},"Da sola, con Rails:",[170,171,172,181,192,200,209],"ul",{},[173,174,175,176,180],"li",{},"le ",[177,178,179],"strong",{},"eccezioni non gestite",", con la richiesta HTTP che le ha causate;",[173,182,183,184,187,188,191],{},"gli errori nei job in background (",[177,185,186],{},"ActiveJob"," e ",[177,189,190],{},"Sidekiq",");",[173,193,194,195,199],{},"gli errori gestiti segnalati con ",[196,197,198],"code",{},"Rails.error.report",";",[173,201,175,202,205,206,199],{},[177,203,204],{},"query lente"," e i ",[177,207,208],{},"metodi lenti",[173,210,175,211,214],{},[177,212,213],{},"metriche dei job"," in background.",[166,216,217],{},"Se lo chiedi tu:",[170,219,220,227,230],{},[173,221,222,223,226],{},"i ",[177,224,225],{},"log strutturati",", legati alla richiesta dallo stesso codice;",[173,228,229],{},"i problemi di performance: N+1, troppe query, chiamate HTTP lente;",[173,231,232],{},"la telemetria d'uso: quali parti dell'app girano davvero.",[166,234,235,236,240],{},"Non raccoglie pagine viste né registra sessioni: per quelle serve ",[237,238,50],"a",{"href":239},"\u002Fit\u002Fdocs\u002Fsdk-javascript",".",[161,242,244],{"id":243},"installa","Installa",[246,247,252],"pre",{"className":248,"code":249,"language":250,"meta":251,"style":251},"language-ruby shiki shiki-themes github-light github-dark","# Gemfile\ngem \"closeyourit-ruby\"\n","ruby","",[196,253,254,261],{"__ignoreMap":251},[255,256,258],"span",{"class":257,"line":8},"line",[255,259,260],{},"# Gemfile\n",[255,262,263],{"class":257,"line":15},[255,264,265],{},"gem \"closeyourit-ruby\"\n",[161,267,269],{"id":268},"configura","Configura",[246,271,273],{"className":248,"code":272,"language":250,"meta":251,"style":251},"# config\u002Finitializers\u002Fcloseyourit.rb\nCloseYourIt.init do |c|\n  c.endpoint_url = \"https:\u002F\u002Fbugs.example.com\"\n  c.token        = ENV[\"CLOSEYOURIT_TOKEN\"]\n  c.project_id   = ENV[\"CLOSEYOURIT_PROJECT_ID\"]\n  c.environment  = Rails.env\nend\n",[196,274,275,280,285,290,295,300,305],{"__ignoreMap":251},[255,276,277],{"class":257,"line":8},[255,278,279],{},"# config\u002Finitializers\u002Fcloseyourit.rb\n",[255,281,282],{"class":257,"line":15},[255,283,284],{},"CloseYourIt.init do |c|\n",[255,286,287],{"class":257,"line":20},[255,288,289],{},"  c.endpoint_url = \"https:\u002F\u002Fbugs.example.com\"\n",[255,291,292],{"class":257,"line":25},[255,293,294],{},"  c.token        = ENV[\"CLOSEYOURIT_TOKEN\"]\n",[255,296,297],{"class":257,"line":30},[255,298,299],{},"  c.project_id   = ENV[\"CLOSEYOURIT_PROJECT_ID\"]\n",[255,301,302],{"class":257,"line":35},[255,303,304],{},"  c.environment  = Rails.env\n",[255,306,307],{"class":257,"line":41},[255,308,309],{},"end\n",[166,311,312],{},"Senza indirizzo, token o progetto la gemma non fa niente: in sviluppo e nei test è sicura.",[161,314,316],{"id":315},"da-sapere","Da sapere",[170,318,319,322,325],{},[173,320,321],{},"L'invio avviene in background: non rallenta la richiesta e non fa mai cadere l'app.",[173,323,324],{},"Nessun dato personale parte, a meno che tu non lo accenda.",[173,326,327,328,331],{},"In produzione un indirizzo ",[196,329,330],{},"http:\u002F\u002F"," viene rifiutato: il token viaggerebbe in chiaro.",[161,333,335],{"id":334},"opentelemetry-e-contesto-delle-richieste","OpenTelemetry e contesto delle richieste",[166,337,338,339,343],{},"La gemma nativa raccoglie errori e problemi di prestazioni. La propagazione W3C facoltativa collega le richieste, ma non trasforma la gemma in un esportatore OTLP. Per operazioni complete e metriche generiche usa un esportatore ufficiale lato server con il ",[237,340,342],{"href":341},"\u002Fit\u002Fdocs\u002Fopentelemetry","ricevitore OpenTelemetry",". Verifica che sia acceso prima di configurarlo.",[345,346,347],"style",{},"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);}",{"title":251,"searchDepth":15,"depth":15,"links":349},[350,351,352,353,354],{"id":163,"depth":15,"text":164},{"id":243,"depth":15,"text":244},{"id":268,"depth":15,"text":269},{"id":315,"depth":15,"text":316},{"id":334,"depth":15,"text":335},{"errors":46,"logs":46,"performance":46,"visits":47,"servers":47},"md",{},true,{"title":39,"description":40},"docs\u002Fsdk-ruby","KYjc_-n5hPMkk_7z2wghIhjaO--cdE-TOFYxDuMhWH8",1791302513936]