Skip to content

Commit 28668c0

Browse files
authored
Docs/self hosted misc (#1266)
1 parent ba2f4dd commit 28668c0

File tree

2 files changed

+35
-9
lines changed

2 files changed

+35
-9
lines changed

docs/reference/self-hosted/installation.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ You will require image pull secrets to pull down the docker images from our priv
2020

2121
The Helm chart does not include a production-ready Postgres Database (only a development instance). You will be required to connect to, and create databases on a Postgres instance.
2222

23-
You will need to create 3 databases, that are used for different things.
23+
You will need to create 3 databases, that are used for different things. It's ok to have them all on the same instance.
2424

2525
While we are currently working on running **Logfire** on one database, for now they *must* be separated.
2626

docs/reference/self-hosted/troubleshooting.md

Lines changed: 34 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -2,14 +2,6 @@
22

33
There are occasions when you need to troubleshoot the installation. Since Logfire sends its own internal logs to the `logfire-meta` organisation, this is a good place to start.
44

5-
## ErrImagePull / ImagePullBackOff
6-
7-
If you are seeing Image pull issues on your logfire pods, make sure you have:
8-
9-
* Created the required Image Pull Secret as described at the [Installation](./installation.md#image-pull-secrets_1) section
10-
* You set the right secret name at `Values.imagePullSecrets`
11-
* Both secret and the release are installed on the same namespace
12-
135
## Accessing the Meta Organization
146

157
Logfire will send internal traces to a meta organisation that is created upon first install. This meta organisation is helpful in troubleshooting any issues that might arise when running Logfire.
@@ -59,3 +51,37 @@ One quick thing to check is the console logs involved in those services. Here a
5951
```
6052
kubectl logs -n logfire deployments/logfire-ff-query-api
6153
```
54+
55+
## ErrImagePull / ImagePullBackOff
56+
57+
If you are seeing Image pull issues on your logfire pods, make sure you have:
58+
59+
* Created the required Image Pull Secret as described at the [Installation](./installation.md#image-pull-secrets_1) section
60+
* You set the right secret name at `Values.imagePullSecrets`
61+
* Both secret and the release are installed on the same namespace
62+
63+
## ff-conhash-cache errors
64+
65+
If you see errors on your conhash-cache pods that look like ```ERROR panic: Failed to build listeners``` or some message like ```Address family not supported by protocol```
66+
67+
This might be due to your hosts having IPv6 disabled.
68+
To fix this, you can add the following to your values file
69+
```
70+
logfire-ff-conhash-cache:
71+
env:
72+
- name: HOST
73+
value: "0.0.0.0"
74+
```
75+
76+
Which will make the cache pod bind only to the IPv4 interface and fix the issue.
77+
78+
## Troubleshooting and support
79+
80+
If this page didn't help, please open a detailed issue on [Github](https://github.com/pydantic/logfire-helm-chart/issues), including:
81+
82+
* Chart version
83+
* Kubernetes version
84+
* A sanitized copy of your ```values.yaml```
85+
* Relevant logs or error messages
86+
87+
For commercial or enterprise support, contact [our sales team](mailto:[email protected]).

0 commit comments

Comments
 (0)