wehub-resource-sync
d718c5a372
CI / compile_and_lint (push) Failing after 0s
CI / docker_build (linux/amd64, -linux-amd64-duckdb, duckdb) (push) Failing after 0s
CI / docker_build (linux/arm64, -linux-arm64, minimal) (push) Failing after 2s
CI / docker_build (linux/arm64, -linux-arm64-duckdb, duckdb) (push) Failing after 1s
CI / docker_build (linux/amd64, minimal) (push) Failing after 1s
CI / test (, sqlite, sqlite::memory:) (push) Has been skipped
CI / test (mssql, mssql, mssql://root:Password123!@127.0.0.1/sqlpage) (push) Has been skipped
CI / test (mysql, mysql, mysql://root:Password123!@127.0.0.1/sqlpage) (push) Has been skipped
CI / test (oracle, oracle, Driver=Oracle 21 ODBC driver;Dbq=//127.0.0.1:1521/FREEPDB1;Uid=root;Pwd=Password123!) (push) Has been skipped
CI / test (postgres, odbc, Driver=PostgreSQL Unicode;Server=127.0.0.1;Port=5432;Database=sqlpage;UID=root;PWD=Password123!, true) (push) Has been skipped
CI / test (postgres, postgres, postgres://root:Password123!@127.0.0.1/sqlpage) (push) Has been skipped
CI / playwright (push) Has been skipped
CI / docker_build (linux/arm/v7, -linux-arm-v7, minimal) (push) Failing after 0s
CI / hurl_examples (push) Failing after 8s
deploy website / deploy_official_site (push) Failing after 1s
CI / hurl (${{ matrix.example }}) (push) Has been skipped
CI / docker_push (duckdb) (push) Has been cancelled
CI / docker_push (minimal) (push) Has been cancelled
CI / windows_test (push) Has been cancelled
62 lines
2.0 KiB
SQL
62 lines
2.0 KiB
SQL
INSERT INTO component(name, icon, introduced_in_version, description) VALUES
|
|
('log', 'logs', '0.37.1', 'A component that writes messages to the server logs.
|
|
When a page runs, it prints your message to the terminal/console (standard error).
|
|
Use it to track what happens and troubleshoot issues.
|
|
|
|
### Where do the messages appear?
|
|
|
|
- Running from a terminal (Linux, macOS, or Windows PowerShell/Command Prompt): they show up in the window.
|
|
- Docker: run `docker logs <container_name>`.
|
|
- Linux service (systemd): run `journalctl -u sqlpage`.
|
|
- This component''s output is written to [standard error (stderr)](https://en.wikipedia.org/wiki/Standard_streams#Standard_error_(stderr)). SQLPage request access logs are separate and are written to standard output (stdout).
|
|
');
|
|
|
|
INSERT INTO parameter(component, name, description, type, top_level, optional) SELECT 'log', * FROM (VALUES
|
|
-- top level
|
|
('message', 'The text to write to the server logs. It is printed when the page runs.', 'TEXT', TRUE, FALSE),
|
|
('level', 'How important the message is. One of ''trace'', ''debug'', ''info'' (default), ''warn'', ''error''. Not case-sensitive. Controls the level shown in the logs.', 'TEXT', TRUE, TRUE)
|
|
) x;
|
|
|
|
INSERT INTO example(component, description) VALUES
|
|
('log', '
|
|
### Record a simple message
|
|
|
|
This writes "Hello, World!" to the server logs.
|
|
|
|
```sql
|
|
SELECT ''log'' as component, ''Hello, World!'' as message;
|
|
```
|
|
|
|
Example output:
|
|
|
|
```text
|
|
[2025-09-13T22:30:14.722Z INFO sqlpage::log from "x.sql" statement 1] Hello, World!
|
|
```
|
|
|
|
### Set the importance (level)
|
|
|
|
Choose how important the message is.
|
|
|
|
```sql
|
|
SELECT ''log'' as component, ''error'' as level, ''This is an error message'' as message;
|
|
```
|
|
|
|
Example output:
|
|
|
|
```text
|
|
[2025-09-13T22:30:14.722Z ERROR sqlpage::log from "x.sql" statement 2] This is an error message
|
|
```
|
|
|
|
### Log dynamic information
|
|
|
|
Include variables like a username.
|
|
|
|
```sql
|
|
set username = ''user''
|
|
|
|
select ''log'' as component,
|
|
''403 - failed for '' || coalesce($username, ''None'') as message,
|
|
''error'' as level;
|
|
```
|
|
')
|