Over dit item
Scribe legt statussen en gebeurtenissen van Home Assistant vast in een TimescaleDB-database via asyncpg. Het draait naast de ingebouwde recorder en bewaart een lange geschiedenis in TimescaleDB, waarbij oude chunks automatisch worden gecomprimeerd en de context van entiteit, apparaat, gebied, gebruiker en integratie samen met de waarden wordt opgeslagen. Het vastleggen kan worden gefilterd op domein, entiteit, naampatroon, attribuut en gebeurtenistype, en schrijfacties worden gebundeld, met een optionele geheugenbuffer die het opnieuw probeert als de database niet beschikbaar is. Optionele sensoren melden schrijfactiviteit, aantallen chunks en tabelgroottes, en overzichten per uur en per dag kunnen worden bijgehouden voor grafieken over een lange periode. Bewaarbeleid voor statussen en gebeurtenissen, een eigen schema en SSL met clientcertificaten zijn beschikbaar in de geavanceerde opties. Problemen zoals een onbereikbare database of een volle buffer verschijnen als reparatiemeldingen, en diagnostiek en systeemstatus zijn inbegrepen. Het wordt toegevoegd via de interface van Home Assistant met een database-URL en maakt lokaal verbinding.
Automatische samenvatting van de README en de code van jonathan-gtd/scribe, automatisch vertaald. Klopt er iets niet, of ben je de maintainer en wil je hier je eigen tekst tonen? Neem contact op
Ondersteunt
Werkt lokaal Praat met je apparaten op je eigen netwerk. Geen cloud van de aanbieder ertussen.
Uit de Marketplace Wordt geïnstalleerd via de Marketplace, voorheen HACS.
Actief onderhouden De auteur heeft in de afgelopen zes maanden een release of wijziging gepubliceerd.
Levert
- Sensoren
Instellen
Installeer de integratie vanuit de Marketplace en herstart Home Assistant. Voeg de integratie daarna toe onder Instellingen > Apparaten en diensten.
Verbinden met TimescaleDB
- Database-URLVolledige PostgreSQL-verbindings-URL, bijv. postgresql://scribe:geheim@192.168.1.10:5432/scribe
Na het instellen
- Statusveranderingen opnemenElke toestandswijziging naar TimescaleDB schrijven
- Gebeurtenissen opnemenWrite Home Assistant events to TimescaleDB
- Domeinen opnemenOnly record entities from these domains.
- Domeinen uitsluitenEntiteiten uit deze domeinen nooit opnemen
- Entiteiten opnemenOnly record these specific entities.
- Entiteiten uitsluitenDeze specifieke entiteiten nooit opnemen
- Entiteitspatronen opnemenOnly record entities matching these patterns
- Entiteitspatronen uitsluitenEntiteiten die op deze patronen passen nooit opnemen
- Attributen uitsluitenDrop these attribute keys before writing
- Gebeurtenistypen opnemenAlleen deze specifieke gebeurtenistypen opnemen. Leeg laten neemt alle gebeurtenissen op.
- Gebeurtenistypen uitsluitenDeze gebeurtenistypen nooit opnemen (na include_events toegepast).
- BatchgrootteNumber of rows accumulated before a flush is triggered
- Verzendinterval (seconden)Maximaal aantal seconden tussen twee automatische schrijfacties (standaard 30). Elke schrijfactie is één transactie: een kort interval schrijft telkens een handvol rijen in plaats van ze te bundelen. Een lang interval riskeert alleen het laatste interval aan historie, en alleen als Home Assistant wordt afgeschoten — bij een normale afsluiting wordt alles weggeschreven.
- Maximale wachtrijgrootteMaximum pending writes before oldest are dropped
- Bufferen bij foutenGebeurtenissen in geheugen houden en opnieuw proberen zodra de database weer beschikbaar is
- I/O-statistieksensoren inschakelenExpose write counters, buffer size and duration as sensors
- Chunk-statistieksensoren inschakelenExpose per-table chunk counts
- Refresh intervalHow often stats are refreshed from the database
- Grootte-statistieksensoren inschakelenExpose per-table sizes and compression ratios
- Refresh intervalHow often stats are refreshed from the database
- Hoe vaak de schrijfsensoren publicerenSeconden tussen twee waarden van de schrijfsensoren. Elke wijziging is een rij die Scribe over zichzelf opneemt, dus een kort interval vult uw historie met Scribes eigen tellers. Standaard 60 seconden.
- Tabel areas synchroniserenKeep a mirror of HA areas in TimescaleDB
- Tabel devices synchroniserenKeep a mirror of HA devices in TimescaleDB
- Tabel integrations synchroniserenKeep a mirror of integrations in TimescaleDB
- Tabel users synchroniserenKeep a mirror of HA users in TimescaleDB
- Uur- en dagsamenvattingenHoud voorberekende uur- en daggemiddelden van uw toestanden bij, onderhouden door TimescaleDB. Grafieken over maanden of jaren lezen dan duizenden rijen in plaats van miljoenen. Voegt de views states_hourly en states_daily toe.
- DatabaseschemaLeeg laten gebruikt waar de verbinding al naar wijst (normaal public). Vul een naam in en Scribe maakt dat schema aan en schrijft erin — zijn tabellen, zijn hypertables, zijn beleidsregels. Alleen nieuwe data gaat erheen: historie die elders al geschreven is, wordt niet verplaatst, en Scribe neemt helemaal niets op als het schema onbereikbaar is.
- Tijdsinterval per chunkTimescaleDB chunk interval
- Comprimeren naCompress chunks older than this interval
- Toestanden verwijderen ouder danLeeg laten bewaart elke toestand voor altijd (standaard). Stel een interval in (bijv. '365 days', '6 months') en TimescaleDB VERWIJDERT toestandshistorie die ouder is — definitief, zonder ongedaan maken. Scribe is eigenaar van dit beleid: het veld legen verwijdert het.
- Gebeurtenissen verwijderen ouder danLeeg laten bewaart elke gebeurtenis voor altijd (standaard). Stel een interval in (bijv. '30 days') en TimescaleDB VERWIJDERT gebeurtenishistorie die ouder is — definitief, zonder ongedaan maken. Scribe is eigenaar van dit beleid: het veld legen verwijdert het.
- SSL inschakelenRequire an SSL/TLS connection
- Pad naar SSL-hoofdcertificaatPath to the CA certificate file
- Pad naar SSL-clientcertificaatPath to the client certificate file
- Pad naar SSL-clientsleutelPath to the client private key file
- Querytime-outSeconden dat een scribe.query-aanroep mag draaien voordat de database hem stopt. Standaard 60.
- Maximaal aantal rijen per queryRijen die een scribe.query-aanroep mag teruggeven voordat hij wordt geweigerd. Ze belanden in het geheugen van Home Assistant, dus dit is wat voorkomt dat een onbedachtzame query het onderuithaalt. Standaard 20000.
Teksten uit de code van jonathan-gtd/scribe.
Probleemoplossing
- DiagnostiekDownloadt een diagnostiekbestand om aan een bugmelding toe te voegen.
- SysteemstatusVoegt de eigen status toe aan de systeeminformatie van Home Assistant.
- ReparatiemeldingenMeldingen die het kan tonen onder Instellingen > Reparaties:Scribe kan zijn database niet bereiken, Scribe kan niet naar zijn database schrijven, De buffer van Scribe is vol — er gaat historie verloren, Scribe gooit records weg, TimescaleDB is niet geïnstalleerd op de database van Scribe, De TLS-configuratie van Scribe geldt niet volledig, Scribe kon zijn tabellen niet aanmaken, De database van Scribe dateert van vóór versie 3.0, Scribe kan het opgegeven schema niet bereiken, Scribe kon zijn samenvattingen niet bouwen
Te zien in Vulpo
Grafiek-kaart, Apple Watch.Informatie
- Installaties
- 81 die analysegegevens delen
- GitHub-sterren
- 67
- Verbinding
- Werkt lokaal
- Onderhoud
- Bijgewerkt in de afgelopen 6 maanden
- Versie
- v4.5.0,
- Soort
- Marketplace-integratie
- Vereist
- Vereist de Marketplace (HACS op 2026.10 en ouder)
- Domein
scribe- Problemen
- Probleem melden











