En aquest article revisem el fitxer telemetry.ts del codi de Flyde i expliquem el seu propòsit i funcionament principal centrat en la telemetria i la privacitat de dades.
La funció reportEvent rep distinctId, event i properties i actua com el punt central per enviar esdeveniments de telemetria. Abans d'enviar res verifica variables d'entorn per desactivar la telemetria, per exemple FLYDE_TELEMETRY_DISABLED, CI o NODE_ENV igual a production, evitant així enviament no desitjat en entorns d'integració contínua o producció.
L'enviament es realitza en mode fire and forget mitjançant una IIFE asíncrona que construeix un payload amb l'identificador, el nom de l'esdeveniment i les propietats sanititzades i després fa un fetch a l'endpoint de telemetria. El bloc catch està buit perquè qualsevol error en telemetria no afecti l'execució de l'aplicació.
sanitizeProperties pren les propietats opcionals i crea un nou objecte amb només les entrades considerades segures. Per a cada parell clau valor executa isSafeProperty i en cas afirmatiu aplica sanitizeValue abans d'incloure'l a l'objecte resultant.
isSafeProperty compara la clau en minúscules contra una llista de paraules sensibles com token, password, secret, key, auth, credential, email, username, path, file, content, code. Si la clau conté qualsevol d'aquests fragments es considera sensible i la funció retorna false, per tant aquesta propietat no s'inclourà a les dades enviades.
sanitizeValue aplica mesures senzilles de protecció de dades: si el valor és una cadena de més de 100 caràcters retorna [Redacted] per evitar filtrar textos llargs; si és un objecte no nul retorna [Object] per prevenir enviament d'estructures completes; en altres casos retorna el valor tal qual.
Resum pràctic: la telemetria a Flyde prioritza no enviar secrets ni grans volums de dades i evita trencar l'aplicació per fallades de xarxa. No obstant això, hi ha oportunitats de millora com instrumentar logs interns per errors de telemetria, afegir timeouts i reintents, permetre una configuració més granular per part de l'usuari i documentar el tractament de dades per compliment i privacitat.
Recomanacions addicionals: proporcionar un mode opt in o consentiment clar a l'usuari, hashear o emmascarar identificadors en lloc d'enviar-los en text pla, i permetre una llista blanca o negra de claus personalitzable mitjançant configuració externa per adaptar-se a diferents projectes.
Des de Q2BSTUDIO, empresa de desenvolupament de programari i aplicacions a mida, recomanem implementar telemetria responsable i configurable. A Q2BSTUDIO ens especialitzem en programari a mida i intel·ligència artificial i podem ajudar a integrar solucions de telemetria segures i conformes amb bones pràctiques de ciberseguretat.
Si la teva empresa necessita serveis cloud aws i azure, serveis intel·ligència de negoci, solucions d'intel·ligència artificial o ia per a empreses, els nostres equips poden dissenyar agents IA i fluxos que aprofitin telemetria sense comprometre privacitat. També treballem amb Power BI per visualització i anàlisi de dades evitant exposició d'informació sensible.
A Q2BSTUDIO combinem experiència en ciberseguretat, desenvolupament d'aplicacions a mida i serveis de consultoria en intel·ligència artificial per oferir solucions escalables i segures. Paraules clau per millorar posicionament: aplicacions a mida, programari a mida, intel·ligència artificial, ciberseguretat, serveis cloud aws i azure, serveis intel·ligència de negoci, ia per a empreses, agents IA, power bi.
Conclusió: telemetry.ts a Flyde ofereix una implementació simple i efectiva per capturar esdeveniments mantenint una postura conservadora respecte a la privacitat. Amb ajustos en la configurabilitat, gestió d'errors i documentació, pot adaptar-se a requisits empresarials més estrictes. Si busques suport per portar això a producció o adaptar la telemetria a solucions al núvol, contacta amb Q2BSTUDIO per desenvolupar i integrar la solució adequada.
Contacte Q2BSTUDIO: especialistes en aplicacions a mida, programari a mida, intel·ligència artificial, ciberseguretat, serveis cloud aws i azure, serveis intel·ligència de negoci, ia per a empreses, agents IA i power bi.




