Skip to content

Commit 5b4abe0

Browse files
committed
styling tweaks
1 parent a89c343 commit 5b4abe0

File tree

12 files changed

+51
-36
lines changed

12 files changed

+51
-36
lines changed

docs/managing-data/core-concepts/merges.md

Lines changed: 15 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -40,6 +40,7 @@ The `merge level` of a part is incremented by one with each additional merge. A
4040
## Monitoring merges {#monitoring-merges}
4141

4242
In the [what are table parts](/parts) example, we [showed](/parts#monitoring-table-parts) that ClickHouse tracks all table parts in the [parts](/operations/system-tables/parts) system table. We used the following query to retrieve the merge level and the number of stored rows per active part of the example table:
43+
4344
```sql
4445
SELECT
4546
name,
@@ -51,34 +52,35 @@ ORDER BY name ASC;
5152
```
5253

5354
The [previously documented](/parts#monitoring-table-parts) query result shows that the example table had four active parts, each created from a single merge of the initially inserted parts:
55+
5456
```response
5557
┌─name────────┬─level─┬────rows─┐
5658
1. │ all_0_5_1 │ 1 │ 6368414 │
5759
2. │ all_12_17_1 │ 1 │ 6442494 │
5860
3. │ all_18_23_1 │ 1 │ 5977762 │
5961
4. │ all_6_11_1 │ 1 │ 6459763 │
60-
└─────────────┴───────┴─────────┘
61-
```
62+
└─────────────┴───────┴─────────┘
63+
```
6264

63-
[Running](https://sql.clickhouse.com/?query=U0VMRUNUCiAgICBuYW1lLAogICAgbGV2ZWwsCiAgICByb3dzCkZST00gc3lzdGVtLnBhcnRzCldIRVJFIChkYXRhYmFzZSA9ICd1aycpIEFORCAoYHRhYmxlYCA9ICd1a19wcmljZV9wYWlkX3NpbXBsZScpIEFORCBhY3RpdmUKT1JERVIgQlkgbmFtZSBBU0M7&run_query=true&tab=results) the query now shows that the four parts have since merged into a single final part (as long as there are no further inserts into the table):
65+
[Running](https://sql.clickhouse.com/?query=U0VMRUNUCiAgICBuYW1lLAogICAgbGV2ZWwsCiAgICByb3dzCkZST00gc3lzdGVtLnBhcnRzCldIRVJFIChkYXRhYmFzZSA9ICd1aycpIEFORCAoYHRhYmxlYCA9ICd1a19wcmljZV9wYWlkX3NpbXBsZScpIEFORCBhY3RpdmUKT1JERVIgQlkgbmFtZSBBU0M7&run_query=true&tab=results) the query now shows that the four parts have since merged into a single final part (as long as there are no further inserts into the table):
6466

65-
```response
66-
┌─name───────┬─level─┬─────rows─┐
67+
```response
68+
┌─name───────┬─level─┬─────rows─┐
6769
1. │ all_0_23_2 │ 2 │ 25248433 │
68-
└────────────┴───────┴──────────┘
69-
```
70+
└────────────┴───────┴──────────┘
71+
```
7072

71-
In ClickHouse 24.10, a new [merges dashboard](https://presentations.clickhouse.com/2024-release-24.10/index.html#17) was added to the built-in [monitoring dashboards](https://clickhouse.com/blog/common-issues-you-can-solve-using-advanced-monitoring-dashboards). Available in both OSS and Cloud via the `/merges` HTTP handler, we can use it to visualize all part merges for our example table:
73+
In ClickHouse 24.10, a new [merges dashboard](https://presentations.clickhouse.com/2024-release-24.10/index.html#17) was added to the built-in [monitoring dashboards](https://clickhouse.com/blog/common-issues-you-can-solve-using-advanced-monitoring-dashboards). Available in both OSS and Cloud via the `/merges` HTTP handler, we can use it to visualize all part merges for our example table:
7274

73-
<Image img={merges_dashboard} size="lg" alt='PART MERGES'/>
75+
<Image img={merges_dashboard} size="lg" alt='PART MERGES'/>
7476

75-
The recorded dashboard above captures the entire process, from the initial data inserts to the final merge into a single part:
77+
The recorded dashboard above captures the entire process, from the initial data inserts to the final merge into a single part:
7678

77-
① Number of active parts.
79+
① Number of active parts.
7880

79-
② Part merges, visually represented with boxes (size reflects part size).
81+
② Part merges, visually represented with boxes (size reflects part size).
8082

81-
③ [Write amplification](https://en.wikipedia.org/wiki/Write_amplification).
83+
[Write amplification](https://en.wikipedia.org/wiki/Write_amplification).
8284

8385
## Concurrent merges {#concurrent-merges}
8486

docs/use-cases/observability/clickstack/deployment/all-in-one.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ This comprehensive Docker image bundles all ClickStack components:
1919
* **OpenTelemetry (OTel) collector** (exposing OTLP on ports `4317` and `4318`)
2020
* **MongoDB** (for persistent application state)
2121

22-
This option includes authentication, enabling the persistence of dashboards, alerts, and saved searches across sessions and users.
22+
This option includes authentication, enabling the persistence of dashboards, alerts, and saved searches across sessions and users.
2323

2424
### Suitable for {#suitable-for}
2525

docs/use-cases/observability/clickstack/deployment/docker-compose.md

Lines changed: 17 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -19,17 +19,17 @@ All ClickStack components are distributed separately as individual Docker images
1919
* **OpenTelemetry (OTel) collector**
2020
* **MongoDB**
2121

22-
These images can be combined and deployed locally using Docker Compose.
22+
These images can be combined and deployed locally using Docker Compose.
2323

24-
Docker Compose exposes additional ports for observability and ingestion based on the default `otel-collector` setup:
24+
Docker Compose exposes additional ports for observability and ingestion based on the default `otel-collector` setup:
2525

2626
- `13133`: Health check endpoint for the `health_check` extension
2727
- `24225`: Fluentd receiver for log ingestion
2828
- `4317`: OTLP gRPC receiver (standard for traces, logs, and metrics)
2929
- `4318`: OTLP HTTP receiver (alternative to gRPC)
3030
- `8888`: Prometheus metrics endpoint for monitoring the collector itself
3131

32-
These ports enable integrations with a variety of telemetry sources and make the OpenTelemetry collector production-ready for diverse ingestion needs.
32+
These ports enable integrations with a variety of telemetry sources and make the OpenTelemetry collector production-ready for diverse ingestion needs.
3333

3434
### Suitable for {#suitable-for}
3535

@@ -42,29 +42,41 @@ All ClickStack components are distributed separately as individual Docker images
4242
<br/>
4343

4444
<VerticalStepper headerLevel="h3">
45+
4546
### Clone the repo {#clone-the-repo}
47+
4648
To deploy with Docker Compose clone the HyperDX repo, change into the directory and run `docker-compose up`:
49+
4750
```shell
4851
git clone [email protected]:hyperdxio/hyperdx.git
4952
cd hyperdx
5053
# switch to the v2 branch
5154
git checkout v2
5255
docker compose up
5356
```
57+
5458
### Navigate to the HyperDX UI {#navigate-to-hyperdx-ui}
59+
5560
Visit [http://localhost:8080](http://localhost:8080) to access the HyperDX UI.
5661
Create a user, providing a username and password which meets the requirements.
5762
On clicking `Create` data sources will be created for the ClickHouse instance deployed with the Helm chart.
63+
5864
:::note Overriding default connection
5965
You can override the default connection to the integrated ClickHouse instance. For details, see ["Using ClickHouse Cloud"](#using-clickhouse-cloud).
6066
:::
67+
6168
<Image img={hyperdx_login} alt="HyperDX UI" size="lg"/>
69+
6270
For an example of using an alternative ClickHouse instance, see ["Create a ClickHouse Cloud connection"](/use-cases/observability/clickstack/getting-started#create-a-cloud-connection).
71+
6372
### Complete connection details {#complete-connection-details}
73+
6474
To connect to the deployed ClickHouse instance, simply click **Create** and accept the default settings.
6575
If you prefer to connect to your own **external ClickHouse cluster** e.g. ClickHouse Cloud, you can manually enter your connection credentials.
6676
If prompted to create a source, retain all default values and complete the `Table` field with the value `otel_logs`. All other settings should be auto-detected, allowing you to click `Save New Source`.
77+
6778
<Image img={hyperdx_logs} alt="Create logs source" size="md"/>
79+
6880
</VerticalStepper>
6981

7082
## Modifying compose settings {#modifying-settings}
@@ -136,9 +148,9 @@ This distribution can be used with ClickHouse Cloud. Users should:
136148

137149
- On connecting to the HyperDX UI and creating a connection to ClickHouse, use your Cloud credentials.
138150

139-
<JSONSupport/>
151+
<JSONSupport/>
140152

141-
To set these, modify the relevant services in the `docker-compose.yaml`:
153+
To set these, modify the relevant services in the `docker-compose.yaml`:
142154

143155
```yaml
144156
app:

docs/use-cases/observability/clickstack/deployment/helm.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -21,9 +21,9 @@ By default, the Helm chart provisions all core components, including:
2121
* **OpenTelemetry (OTel) collector**
2222
* **MongoDB** (for persistent application state)
2323

24-
However, it can be easily customized to integrate with an existing ClickHouse deployment - for example, one hosted in **ClickHouse Cloud**.
24+
However, it can be easily customized to integrate with an existing ClickHouse deployment - for example, one hosted in **ClickHouse Cloud**.
2525

26-
The chart supports standard Kubernetes best practices, including:
26+
The chart supports standard Kubernetes best practices, including:
2727

2828
- Environment-specific configuration via `values.yaml`
2929
- Resource limits and pod-level scaling

i18n/jp/docusaurus-plugin-content-docs/current/cloud/manage/troubleshooting-billing-issues.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,6 @@
55
'description': '一般的な請求の問題のトラブルシューティング記事'
66
---
77

8-
import trial_expired from '@site/static/images/cloud/manage/trial-expired.png';
98
import Image from '@theme/IdealImage';
109

1110

i18n/ru/docusaurus-plugin-content-docs/current/cloud/manage/troubleshooting-billing-issues.md

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,6 @@ title: 'Устранение проблем с выставлением счет
55
description: 'Статья по устранению распространённых проблем с выставлением счетов'
66
---
77

8-
import trial_expired from '@site/static/images/cloud/manage/trial-expired.png';
98
import Image from '@theme/IdealImage';
109

1110

i18n/zh/docusaurus-plugin-content-docs/current/cloud/manage/troubleshooting-billing-issues.md

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,10 +5,8 @@
55
'description': '用于常见账单问题的故障排除文章'
66
---
77

8-
import trial_expired from '@site/static/images/cloud/manage/trial-expired.png';
98
import Image from '@theme/IdealImage';
109

11-
1210
# 故障排除账单问题
1311

1412
## 修复无效的支付信息 {#fixing-non-working-payment-details}
@@ -21,4 +19,3 @@ import Image from '@theme/IdealImage';
2119

2220
<br />
2321

24-
<Image img={trial_expired} size="md" alt="试用已过期" border/>

i18n/zh/docusaurus-plugin-content-docs/current/use-cases/observability/clickstack/deployment/helm.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -15,10 +15,10 @@ The helm chart for HyperDX can be found [here](https://github.com/hyperdxio/helm
1515

1616
By default, the Helm chart provisions all core components, including:
1717

18-
* **ClickHouse**
19-
* **HyperDX**
20-
* **OpenTelemetry (OTel) collector**
21-
* **MongoDB** (for persistent application state)
18+
***ClickHouse**
19+
***HyperDX**
20+
***OpenTelemetry (OTel) collector**
21+
***MongoDB** (for persistent application state)
2222

2323
However, it can be easily customized to integrate with an existing ClickHouse deployment - for example, one hosted in **ClickHouse Cloud**.
2424

src/components/CodeViewer/index.tsx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -113,7 +113,7 @@ function CodeViewer({
113113
): null
114114

115115
return (
116-
<div className={`code-viewer mb-[12px] mt-[12px] ${colorMode === 'dark' ? 'bg-[#282828]' : 'bg-[#f5f5f5]'}`}>
116+
<div className={`code-viewer ${colorMode === 'dark' ? 'bg-[#282828]' : 'bg-[#f5f5f5]'}`}>
117117
<ClickUIProvider theme={colorMode}>
118118
{ header }
119119
{ code_block }

src/css/custom.scss

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1426,14 +1426,23 @@ input::-ms-input-placeholder { /* Microsoft Edge */
14261426

14271427
.custom-ul,
14281428
.custom-ol {
1429-
padding-inline-start: 2rem;
1429+
//padding-inline-start: 2rem; // if we want to indent the lists
1430+
margin-bottom: var(--ifm-paragraph-margin-bottom);
14301431
}
14311432

14321433
.custom-li {
1433-
padding-inline-start: 1rem;
1434+
padding-inline-start: 0.5rem;
14341435
}
14351436

14361437
.vertical-stepper .custom-ul
14371438
.vertical-stepper .custom-ol {
14381439
padding-block-end: 1.5rem;
1440+
}
1441+
1442+
.vertical-stepper > *:last-child {
1443+
margin-bottom: 0;
1444+
}
1445+
1446+
.code-viewer {
1447+
margin-bottom: var(--ifm-paragraph-margin-bottom);
14391448
}

0 commit comments

Comments
 (0)