{"id":26788213,"url":"https://github.com/devops-works/slowql","last_synced_at":"2025-04-19T20:50:45.585Z","repository":{"id":39332495,"uuid":"341510677","full_name":"devops-works/slowql","owner":"devops-works","description":"A package to parse slow query logs in Go, with associated tooling (digester, replayer...), and compatible with multiple databases (MySQL, MariaDB, PerconaDB...).","archived":false,"fork":false,"pushed_at":"2024-02-15T08:36:09.000Z","size":124,"stargazers_count":38,"open_issues_count":2,"forks_count":8,"subscribers_count":5,"default_branch":"main","last_synced_at":"2024-11-16T14:36:07.460Z","etag":null,"topics":["go","mariadb","mysql","package","percona","slow-query-logs","sql"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/devops-works.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-02-23T10:09:58.000Z","updated_at":"2024-10-14T08:45:41.000Z","dependencies_parsed_at":"2024-02-15T09:45:47.458Z","dependency_job_id":null,"html_url":"https://github.com/devops-works/slowql","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devops-works%2Fslowql","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devops-works%2Fslowql/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devops-works%2Fslowql/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devops-works%2Fslowql/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/devops-works","download_url":"https://codeload.github.com/devops-works/slowql/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246187233,"owners_count":20737463,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["go","mariadb","mysql","package","percona","slow-query-logs","sql"],"created_at":"2025-03-29T13:16:22.364Z","updated_at":"2025-03-29T13:16:22.967Z","avatar_url":"https://github.com/devops-works.png","language":"Go","readme":"# slowql\n\n[![Go Reference](https://pkg.go.dev/badge/devops-works/slowql.svg)](https://pkg.go.dev/devops-works/slowql)\n[![Go Report Card](https://goreportcard.com/badge/github.com/devops-works/slowql)](https://goreportcard.com/report/github.com/devops-works/slowql)\n\nA slow query logs parser in Golang.\n\n- [slowql](#slowql)\n  - [Getting started](#getting-started)\n  - [Basic usage](#basic-usage)\n  - [Performance](#performance)\n  - [Associated tools](#associated-tools)\n  - [Notes](#notes)\n    - [Tested databases](#tested-databases)\n  - [Contributing](#contributing)\n  - [License](#license)\n\n## Getting started\n\n```\ngo get github.com/devops-works/slowql\n```\n\n## Basic usage\n\nIn a nutshell, you can use it as follows:\n\n```go\npackage main\n\nimport (\n    \"fmt\"\n\n    \"github.com/devops-works/slowql\"\n)\n\nfunc main() {\n    // Imagine that fd is an io.Reader of your slow query logs file...\n\n    // Create the parser\n    p := slowql.NewParser(slowql.MySQL, fd)\n\n    // Get the next query from the log\n    q, err := p.GetNext()\n\t  if err != nil {\n\t\t    panic(err)\n\t  }\n\n    // Do your stuff, for example:\n    fmt.Printf(\"at %d, %s did the request: %s\\n\", q.Time, q.User, q.Query)\n\n    fp, err := q.Fingerprint()\n    if err != nil {\n        panic(err)\n    }\n    fmt.Printf(\"the query fingerprint is: %s\\n\", fp)\n\n    srv := p.GetServerMeta()\n    fmt.Printf(\"the SQL server listens to port %d\", srv.Port)\n}\n```\n\n## Performance\n\nRunning the example given in cmd/ without any `fmt.Printf` against a 292MB slow query logs from a MySQL database provides the following output:\n\n```\nparsed 278077 queries in 8.099622786s\n```\n\nwhich is approx. **34760 queries/second** (Intel i5-8250U (8) @ 3.400GHz).\n\n## Associated tools\n\nWith this package we created some tools:\n\n* [slowql-replayer](https://github.com/devops-works/slowql/tree/develop/cmd/slowql-replayer): replay and benchmark queries from a slow query log\n* [slowql-digest](https://github.com/devops-works/slowql/tree/develop/cmd/slowql-digest): digest and analyze slow query logs. Similar to `pt-query-digest`, but faster. :upside_down_face:\n\n## Notes\n\n### Tested databases\n\nNot all kind of slow query logs have been tested yet:\n\n- [X] MySQL\n- [X] MariaDB\n- [ ] Percona-db\n- [X] Percona-cluster (pxc)\n\n## Contributing\n\nIssues and pull requests are welcomed ! If you found a bug or want to help and improve this package don't hesitate to fork it or open an issue :smile:\n\n## License\n\nMIT","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevops-works%2Fslowql","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevops-works%2Fslowql","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevops-works%2Fslowql/lists"}