Telemetriakäytäntö
STH on Alpha-vaiheessa. CLI voi lähettää minimaalista telemetriaa — mutta vain jos hyväksyit sen nimenomaisesti ensimmäisen `sth init` -komennon yhteydessä.
Miksi keräämme
Alpha-vaiheen tarkoitus on validoida työkalu ja priorisoida seuraavat askeleet. Tieto siitä, mitä komentoja käytetään, kuinka usein ja millä CLI-versiolla, auttaa kohdistamaan kehitystyötä oikein. Ilman näitä tietoja arvailemme — ja arvailut vanhenevat nopeasti.
Kolme tilaa
Telemetria on nimenomainen valinta, joka tehdään ensimmäisellä `sth init` -kerralla ja jota voi muuttaa milloin tahansa komennolla `sth telemetry`. Lähetettävä sisältö riippuu aktiivisesta tilasta:
off— mitään ei lähetetä — ei pyyntöä, ei tietuetta.anonymous— vain alla olevat kolme paikallista kenttää, ilman avainta tai tunnistetta. Mitään ei liitetä organisaatioon tai henkilöön; tietueet sijaitsevat omassa taulussaan, erillään tileistä.connected— samat kolme kenttää sekä `org_id`, jonka palvelin johtaa API-avaimestasi. Käyttö ryhmitellään tällöin organisaation mukaan ja näkyy Usage-sivullasi.
Mitä keräämme
CLI:n lähettämä hyötykuorma on tarkoituksellisen minimaalinen: kolme paikallista kenttää, samat kaikissa tiloissa. Vain connected-tilassa palvelin lisää organisaatiosi (`org_id`), joka johdetaan API-avaimestasi; anonymous-tilassa mitään ei lisätä.
| Kenttä | Esimerkki | Miksi |
|---|---|---|
ts | 2026-05-11T10:30:00Z | Komennon UTC-aikaleima — paljastaa aktiivisuushuiput ja toiminnan tuoreuden. |
cli_version | v0.1.2 | Binäärin versio — tunnistaa ketkä käyttävät yhä vanhempia versioita, ohjaa julkaisutiedotteita. |
command_name | install | Komennon nimi, ilman argumentteja. Näyttää, mitä toimintoja käytetään eniten. |
org_id (vain connected-tila) | uuid | Palvelin johtaa sen API-avaimestasi, ja vain connected-tilassa — käytetään käytön ryhmittelyyn organisaation tasolla, ei koskaan henkilökohtaisesti. Anonymous-tilassa sitä ei lähetetä. |
Mitä EMME kerää
Nämä elementit eivät koskaan poistu koneeltasi, hyötykuorman rakenteen ansiosta:
- Komennon argumentit (`sth install acme/secret-skill` lähettää vain `install`).
- Ei tiedostopolkuja, absoluuttisia eikä suhteellisia.
- Ei tiedostojen sisältöä, koskaan.
- Ei asennettujen skillien sisältöä, nimiä eikä lähteitä.
- Ei tokeneita, avaimia eikä salaisuuksia.
- IP-osoitteita ei tallenneta nimenomaisesti — palvelimen lokit säilyttävät niitä enintään 12 kuukautta (ks. tietosuojakäytäntö).
Anonyymisyys
Anonymous-tilassa tieto on aidosti anonyymiä: ei avainta, ei org_id:tä, ei mitään, mikä voisi liittää sen sinuun tai organisaatioosi. Connected-tilassa se on pseudo-anonyymiä — liitetty organisaatioon API-avaimesi kautta, mutta ilman tunnistetietoja CLI-puolella.
Tiukan GDPR:n näkökulmasta connected-tila tuottaa pseudonyymiä (ei täysin anonyymiä) tietoa: STH:n superadmin, jolla on pääsy molempiin tauluihin, voisi yhdistää käyttötietueen organisaatioon. Tämän vuoksi pääsy on rajoitettu (ks. seuraava osio). Anonymous-tila ei sisällä tällaista yhteyttä.
Kuka näkee tiedot
Vain STH:n superadminit pääsevät käsiksi raakatietueisiin tuotannon Supabase-työkalujen kautta. Muut dashboard-roolit (owner, admin, member) näkevät vain oman organisaationsa käytön Usage-sivulla.
Säilytysaika
Tietueet säilytetään 30 päivää liukuvasti. Sen jälkeen ne poistetaan. Tämä vastaa tuotteen yleistä tietosuojakäytäntöä.
Kieltäydy milloin tahansa
Suostumusta kysytään kerran, ensimmäisellä `sth init` -kerralla. Päätös tallennetaan käyttäjäasetuksiisi. Mielen muuttuessa milloin tahansa:
sth telemetry off
sth telemetry statusTarkastele omia tietojasi
Nähdäksesi tarkalleen, mitä palvelin on tallentanut CLI-toiminnastasi, suorita:
sth telemetry output --limit=20