ooni-probe-cli/internal/engine/netx
Simone Basso 6212daa54a
fix(tracex): generate archival from single transaction-done event (#780)
Tracex contained some fragile code that assembled HTTP measurements
from scattered events, which worked because we were sure we were
performing a single measurement at any given time.

This diff restructures the code to emit a transaction-start and a
transaction-done events only. We have basically removed all the other
events (which we were not using). We kept the transaction-start
though, because it may be useful to see it when reading events. In
any case, what matters here is that we're now using the transaction-done
event aline to generate the archival HTTP measurement.

Hence, the original issue has been addressed. We will possibly
do more refactoring in the future, but for now this seems sufficient.

Part of https://github.com/ooni/probe/issues/2121
2022-06-01 19:27:47 +02:00
..
dialer refactor(netxlite): better integration with tracex (#774) 2022-06-01 08:31:20 +02:00
httptransport refactor(netx): merge archival, trace, and the savers (#772) 2022-05-31 21:53:01 +02:00
resolver feat(netxlite): implement DNSTransport wrapping (#776) 2022-06-01 11:10:08 +02:00
tlsdialer refactor(netx): merge archival, trace, and the savers (#772) 2022-05-31 21:53:01 +02:00
tracex fix(tracex): generate archival from single transaction-done event (#780) 2022-06-01 19:27:47 +02:00
fake_test.go cleanup: remove unnecessary legacy interfaces (#656) 2022-01-07 18:33:37 +01:00
integration_test.go refactor(netx): merge archival, trace, and the savers (#772) 2022-05-31 21:53:01 +02:00
netx_internal_test.go chore: merge probe-engine into probe-cli (#201) 2021-02-02 12:05:47 +01:00
netx_test.go fix(tracex): generate archival from single transaction-done event (#780) 2022-06-01 19:27:47 +02:00
netx.go fix(tracex): generate archival from single transaction-done event (#780) 2022-06-01 19:27:47 +02:00
README.md chore: merge probe-engine into probe-cli (#201) 2021-02-02 12:05:47 +01:00

Package github.com/ooni/probe-engine/netx

OONI extensions to the net and net/http packages. This code is used by ooni/probe-engine as a low level library to collect network, DNS, and HTTP events occurring during OONI measurements.

This library contains replacements for commonly used standard library interfaces that facilitate seamless network measurements. By using such replacements, as opposed to standard library interfaces, we can:

  • save the timing of HTTP events (e.g. received response headers)
  • save the timing and result of every Connect, Read, Write, Close operation
  • save the timing and result of the TLS handshake (including certificates)

By default, this library uses the system resolver. In addition, it is possible to configure alternative DNS transports and remote servers. We support DNS over UDP, DNS over TCP, DNS over TLS (DoT), and DNS over HTTPS (DoH). When using an alternative transport, we are also able to intercept and save DNS messages, as well as any other interaction with the remote server (e.g., the result of the TLS handshake for DoT and DoH).

This package is a fork of github.com/ooni/netx.