Skip to content

Commit

Permalink
Refine log extraction instructions
Browse files Browse the repository at this point in the history
  • Loading branch information
supermario committed Feb 5, 2021
1 parent 584e5cc commit 3d39fc2
Showing 1 changed file with 55 additions and 5 deletions.
60 changes: 55 additions & 5 deletions logs.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@

### Log submission
## Log submission

For B1+B2/B3/B4 challenges, proof of runtime via logs is required.

Expand All @@ -16,21 +16,71 @@ Simply run the relevant binary on your system where the Concordium Node has been



### Log sizes & rotation

## Log sizes

After running the node for a significant time you may find that you are running out of disk space on your node.

You can find your log file location by running:
Please try the following things.

### 1. Run the log summary tool

Download the appropriate executable linked above, and run it.

Add the output file, unmodified, to your single submission PR. You can replace this file in future with a larger runtime summary, or add further files if you are forced to clear logs.

Then move onto step 2.

If you cannot run it (it fails/breaks), move onto step 2.


### 2. Try clear up excess lines in your log

If (1) did not succeed, or you just wish to clear some space, try these commands to strip out excess lines in your log:

Linux:
```
docker inspect --format='{{.LogPath}}' <container_name_or_id>
sed -i "/priority/d" `docker inspect --format='{{.LogPath}}' concordium-client`
```

Where the `<container_name_or_id>` is found by running `docker ps -a`.
macOS (you'll need [homebrew](https://brew.sh/)):
```
brew install gnu-sed
gsed -i "/priority/d" `docker inspect --format='{{.LogPath}}' concordium-client`
```

Windows:
```
Get-Content <file> | Select-String -pattern 'priority' -notmatch | Out-File <new-file>
```

You can now try step (1) again if it did not succeed before.

If this succeeds, great! Nothing more to do.

If this fails, move onto (3).


### 3. Advanced log extraction options

For this you'll need to speak with our team. Please post your issue in the [#testnet_support channel on Discord](https://discord.com/channels/667378330923696158/687313907500449849).

We may be able to help with some different commands/strategies for extraction depending on your situation.


### 4. Clear your logs entirely

**⚠️ Make sure you generate log summaries for submission _before_ clearing any logs!**

This should only be done as a last resort, if 1/2/3 have failed, and someone from `[Team]` has told you to do so on Discord.

You can find your log file location by running:

```
docker inspect --format='{{.LogPath}}' <container_name_or_id>
```

Where the `<container_name_or_id>` is found by running `docker ps -a`.

You can then clear out your current logs via the command line:

Expand Down

0 comments on commit 3d39fc2

Please sign in to comment.