gitlab-ce/spec/frontend/observability/client_spec.js

1166 lines
37 KiB
JavaScript

import MockAdapter from 'axios-mock-adapter';
import * as Sentry from '~/sentry/sentry_browser_wrapper';
import { buildClient } from '~/observability/client';
import axios from '~/lib/utils/axios_utils';
import { logError } from '~/lib/logger';
import { DEFAULT_SORTING_OPTION, SORTING_OPTIONS } from '~/observability/constants';
jest.mock('~/lib/utils/axios_utils');
jest.mock('~/sentry/sentry_browser_wrapper');
jest.mock('~/lib/logger');
describe('buildClient', () => {
let client;
let axiosMock;
const tracingUrl = 'https://example.com/tracing';
const tracingAnalyticsUrl = 'https://example.com/tracing/analytics';
const provisioningUrl = 'https://example.com/provisioning';
const servicesUrl = 'https://example.com/services';
const operationsUrl = 'https://example.com/services/$SERVICE_NAME$/operations';
const metricsUrl = 'https://example.com/metrics';
const metricsSearchUrl = 'https://example.com/metrics/search';
const metricsSearchMetadataUrl = 'https://example.com/metrics/searchmetadata';
const logsSearchUrl = 'https://example.com/metrics/logs/search';
const FETCHING_TRACES_ERROR = 'traces are missing/invalid in the response';
const apiConfig = {
tracingUrl,
tracingAnalyticsUrl,
provisioningUrl,
servicesUrl,
operationsUrl,
metricsUrl,
metricsSearchUrl,
metricsSearchMetadataUrl,
logsSearchUrl,
};
const getQueryParam = () => decodeURIComponent(axios.get.mock.calls[0][1].params.toString());
beforeEach(() => {
axiosMock = new MockAdapter(axios);
jest.spyOn(axios, 'get');
client = buildClient(apiConfig);
});
afterEach(() => {
axiosMock.restore();
});
const expectErrorToBeReported = (e) => {
expect(Sentry.captureException).toHaveBeenCalledWith(e);
expect(logError).toHaveBeenCalledWith(e);
};
describe('buildClient', () => {
it('throws is option is missing', () => {
expect(() => buildClient()).toThrow(new Error('No options object provided'));
});
it.each(Object.keys(apiConfig))('throws if %s is missing', (param) => {
const e = new Error(`${param} param must be a string`);
expect(() =>
buildClient({
...apiConfig,
[param]: undefined,
}),
).toThrow(e);
});
});
describe('isObservabilityEnabled', () => {
it('returns true if requests succeedes', async () => {
axiosMock.onGet(provisioningUrl).reply(200, {
status: 'ready',
});
const enabled = await client.isObservabilityEnabled();
expect(enabled).toBe(true);
});
it('returns false if response is 404', async () => {
axiosMock.onGet(provisioningUrl).reply(404);
const enabled = await client.isObservabilityEnabled();
expect(enabled).toBe(false);
});
// we currently ignore the 'status' payload and just check if the request was successful
// We might improve this as part of https://gitlab.com/gitlab-org/opstrace/opstrace/-/issues/2315
it('returns true for any status', async () => {
axiosMock.onGet(provisioningUrl).reply(200, {
status: 'not ready',
});
const enabled = await client.isObservabilityEnabled();
expect(enabled).toBe(true);
});
it('throws in case of any non-404 error', async () => {
axiosMock.onGet(provisioningUrl).reply(500);
const e = 'Request failed with status code 500';
await expect(client.isObservabilityEnabled()).rejects.toThrow(e);
expectErrorToBeReported(new Error(e));
});
it('throws in case of unexpected response', async () => {
axiosMock.onGet(provisioningUrl).reply(200, {});
const e = 'Failed to check provisioning';
await expect(client.isObservabilityEnabled()).rejects.toThrow(e);
expectErrorToBeReported(new Error(e));
});
});
describe('enableObservability', () => {
it('makes a PUT request to the provisioning URL', async () => {
let putConfig;
axiosMock.onPut(provisioningUrl).reply((config) => {
putConfig = config;
return [200];
});
await client.enableObservability();
expect(putConfig.withCredentials).toBe(true);
});
it('reports an error if the req fails', async () => {
axiosMock.onPut(provisioningUrl).reply(401);
const e = 'Request failed with status code 401';
await expect(client.enableObservability()).rejects.toThrow(e);
expectErrorToBeReported(new Error(e));
});
});
describe('fetchTrace', () => {
it('fetches the trace from the tracing URL', async () => {
const mockTrace = {
trace_id: 'trace-1',
duration_nano: 3000,
spans: [{ duration_nano: 1000 }, { duration_nano: 2000 }],
};
axiosMock.onGet(`${tracingUrl}/trace-1`).reply(200, mockTrace);
const result = await client.fetchTrace('trace-1');
expect(axios.get).toHaveBeenCalledTimes(1);
expect(axios.get).toHaveBeenCalledWith(`${tracingUrl}/trace-1`, {
withCredentials: true,
});
expect(result).toEqual(mockTrace);
});
it('rejects if trace id is missing', () => {
return expect(client.fetchTrace()).rejects.toThrow('traceId is required.');
});
});
describe('fetchTraces', () => {
it('fetches traces from the tracing URL', async () => {
const mockResponse = {
traces: [
{
trace_id: 'trace-1',
duration_nano: 3000,
spans: [{ duration_nano: 1000 }, { duration_nano: 2000 }],
},
{ trace_id: 'trace-2', duration_nano: 3000, spans: [{ duration_nano: 2000 }] },
],
};
axiosMock.onGet(tracingUrl).reply(200, mockResponse);
const result = await client.fetchTraces();
expect(axios.get).toHaveBeenCalledTimes(1);
expect(axios.get).toHaveBeenCalledWith(tracingUrl, {
withCredentials: true,
params: expect.any(URLSearchParams),
});
expect(result).toEqual(mockResponse);
});
it('rejects if traces are missing', async () => {
axiosMock.onGet(tracingUrl).reply(200, {});
await expect(client.fetchTraces()).rejects.toThrow(FETCHING_TRACES_ERROR);
expectErrorToBeReported(new Error(FETCHING_TRACES_ERROR));
});
it('rejects if traces are invalid', async () => {
axiosMock.onGet(tracingUrl).reply(200, { traces: 'invalid' });
await expect(client.fetchTraces()).rejects.toThrow(FETCHING_TRACES_ERROR);
expectErrorToBeReported(new Error(FETCHING_TRACES_ERROR));
});
it('passes the abort controller to axios', async () => {
axiosMock.onGet(tracingUrl).reply(200, { traces: [] });
const abortController = new AbortController();
await client.fetchTraces({ abortController });
expect(axios.get).toHaveBeenCalledWith(tracingUrl, {
withCredentials: true,
params: expect.any(URLSearchParams),
signal: abortController.signal,
});
});
describe('sort order', () => {
beforeEach(() => {
axiosMock.onGet(tracingUrl).reply(200, {
traces: [],
});
});
it('appends sort param if specified', async () => {
await client.fetchTraces({ sortBy: SORTING_OPTIONS.DURATION_DESC });
expect(getQueryParam()).toBe(`sort=${SORTING_OPTIONS.DURATION_DESC}`);
});
it('defaults to DEFAULT_SORTING_OPTION if no sortBy param is specified', async () => {
await client.fetchTraces();
expect(getQueryParam()).toBe(`sort=${DEFAULT_SORTING_OPTION}`);
});
it('defaults to timestamp_desc if sortBy param is not an accepted value', async () => {
await client.fetchTraces({ sortBy: 'foo-bar' });
expect(getQueryParam()).toBe(`sort=${SORTING_OPTIONS.TIMESTAMP_DESC}`);
});
});
describe('query filter', () => {
beforeEach(() => {
axiosMock.onGet(tracingUrl).reply(200, {
traces: [],
});
});
it('does not set any query param without filters', async () => {
await client.fetchTraces();
expect(getQueryParam()).toBe(`sort=${SORTING_OPTIONS.TIMESTAMP_DESC}`);
});
it('appends page_token if specified', async () => {
await client.fetchTraces({ pageToken: 'page-token' });
expect(getQueryParam()).toContain('page_token=page-token');
});
it('appends page_size if specified', async () => {
await client.fetchTraces({ pageSize: 10 });
expect(getQueryParam()).toContain('page_size=10');
});
it('converts filter to proper query params', async () => {
await client.fetchTraces({
filters: {
durationMs: [
{ operator: '>', value: '100' },
{ operator: '<', value: '1000' },
],
operation: [
{ operator: '=', value: 'op' },
{ operator: '!=', value: 'not-op' },
],
service: [
{ operator: '=', value: 'service' },
{ operator: '!=', value: 'not-service' },
],
period: [{ operator: '=', value: '5m' }],
status: [
{ operator: '=', value: 'ok' },
{ operator: '!=', value: 'error' },
],
traceId: [
{ operator: '=', value: 'trace-id' },
{ operator: '!=', value: 'not-trace-id' },
],
attribute: [{ operator: '=', value: 'name1=value1' }],
},
});
expect(getQueryParam()).toContain(
'gt[duration_nano]=100000000&lt[duration_nano]=1000000000' +
'&operation=op&not[operation]=not-op' +
'&service_name=service&not[service_name]=not-service' +
'&period=5m' +
'&trace_id=trace-id&not[trace_id]=not-trace-id' +
'&attr_name=name1&attr_value=value1' +
'&status=ok&not[status]=error',
);
});
describe('date range time filter', () => {
it('handles custom date range period filter', async () => {
await client.fetchTraces({
filters: {
period: [{ operator: '=', value: '2023-01-01 - 2023-02-01' }],
},
});
expect(getQueryParam()).not.toContain('period=');
expect(getQueryParam()).toContain(
'start_time=2023-01-01T00:00:00.000Z&end_time=2023-02-01T00:00:00.000Z',
);
});
it.each([
'invalid - 2023-02-01',
'2023-02-01 - invalid',
'invalid - invalid',
'2023-01-01 / 2023-02-01',
'2023-01-01 2023-02-01',
'2023-01-01 - 2023-02-01 - 2023-02-01',
])('ignore invalid values', async (val) => {
await client.fetchTraces({
filters: {
period: [{ operator: '=', value: val }],
},
});
expect(getQueryParam()).not.toContain('start_time=');
expect(getQueryParam()).not.toContain('end_time=');
expect(getQueryParam()).not.toContain('period=');
});
});
it('handles repeated params', async () => {
await client.fetchTraces({
filters: {
operation: [
{ operator: '=', value: 'op' },
{ operator: '=', value: 'op2' },
],
},
});
expect(getQueryParam()).toContain('operation=op&operation=op2');
});
it('ignores unsupported filters', async () => {
await client.fetchTraces({
filters: {
unsupportedFilter: [{ operator: '=', value: 'foo' }],
},
});
expect(getQueryParam()).toBe(`sort=${SORTING_OPTIONS.TIMESTAMP_DESC}`);
});
it('ignores empty filters', async () => {
await client.fetchTraces({
filters: {
durationMs: null,
traceId: undefined,
},
});
expect(getQueryParam()).toBe(`sort=${SORTING_OPTIONS.TIMESTAMP_DESC}`);
});
it('ignores non-array filters', async () => {
await client.fetchTraces({
filters: {
traceId: { operator: '=', value: 'foo' },
},
});
expect(getQueryParam()).toBe(`sort=${SORTING_OPTIONS.TIMESTAMP_DESC}`);
});
it('ignores unsupported operators', async () => {
await client.fetchTraces({
filters: {
durationMs: [
{ operator: '*', value: 'foo' },
{ operator: '=', value: 'foo' },
{ operator: '!=', value: 'foo' },
],
operation: [
{ operator: '>', value: 'foo' },
{ operator: '<', value: 'foo' },
],
service: [
{ operator: '>', value: 'foo' },
{ operator: '<', value: 'foo' },
],
period: [{ operator: '!=', value: 'foo' }],
traceId: [
{ operator: '>', value: 'foo' },
{ operator: '<', value: 'foo' },
],
},
});
expect(getQueryParam()).toBe(`sort=${SORTING_OPTIONS.TIMESTAMP_DESC}`);
});
});
});
describe('fetchTracesAnalytics', () => {
it('fetches analytics from the tracesAnalytics URL', async () => {
const mockResponse = {
results: [
{
Interval: 1705039800,
count: 5,
p90_duration_nano: 50613502867,
p95_duration_nano: 50613502867,
p75_duration_nano: 49756727928,
p50_duration_nano: 41610120929,
error_count: 324,
trace_rate: 2.576111111111111,
error_rate: 0.09,
},
],
};
axiosMock.onGet(tracingAnalyticsUrl).reply(200, mockResponse);
const result = await client.fetchTracesAnalytics();
expect(axios.get).toHaveBeenCalledTimes(1);
expect(axios.get).toHaveBeenCalledWith(tracingAnalyticsUrl, {
withCredentials: true,
params: expect.any(URLSearchParams),
});
expect(result).toEqual(mockResponse.results);
});
it('returns empty array if analytics are missing', async () => {
axiosMock.onGet(tracingAnalyticsUrl).reply(200, {});
expect(await client.fetchTracesAnalytics()).toEqual([]);
});
it('passes the abort controller to axios', async () => {
axiosMock.onGet(tracingAnalyticsUrl).reply(200, {});
const abortController = new AbortController();
await client.fetchTracesAnalytics({ abortController });
expect(axios.get).toHaveBeenCalledWith(tracingAnalyticsUrl, {
withCredentials: true,
params: expect.any(URLSearchParams),
signal: abortController.signal,
});
});
describe('query filter', () => {
beforeEach(() => {
axiosMock.onGet(tracingAnalyticsUrl).reply(200, {
results: [],
});
});
it('does not set any query param without filters', async () => {
await client.fetchTracesAnalytics();
expect(getQueryParam()).toBe(``);
});
it('converts filter to proper query params', async () => {
await client.fetchTracesAnalytics({
filters: {
durationMs: [
{ operator: '>', value: '100' },
{ operator: '<', value: '1000' },
],
operation: [
{ operator: '=', value: 'op' },
{ operator: '!=', value: 'not-op' },
],
service: [
{ operator: '=', value: 'service' },
{ operator: '!=', value: 'not-service' },
],
period: [{ operator: '=', value: '5m' }],
status: [
{ operator: '=', value: 'ok' },
{ operator: '!=', value: 'error' },
],
traceId: [
{ operator: '=', value: 'trace-id' },
{ operator: '!=', value: 'not-trace-id' },
],
attribute: [{ operator: '=', value: 'name1=value1' }],
},
});
expect(getQueryParam()).toContain(
'gt[duration_nano]=100000000&lt[duration_nano]=1000000000' +
'&operation=op&not[operation]=not-op' +
'&service_name=service&not[service_name]=not-service' +
'&period=5m' +
'&trace_id=trace-id&not[trace_id]=not-trace-id' +
'&attr_name=name1&attr_value=value1' +
'&status=ok&not[status]=error',
);
});
describe('date range time filter', () => {
it('handles custom date range period filter', async () => {
await client.fetchTracesAnalytics({
filters: {
period: [{ operator: '=', value: '2023-01-01 - 2023-02-01' }],
},
});
expect(getQueryParam()).not.toContain('period=');
expect(getQueryParam()).toContain(
'start_time=2023-01-01T00:00:00.000Z&end_time=2023-02-01T00:00:00.000Z',
);
});
it.each([
'invalid - 2023-02-01',
'2023-02-01 - invalid',
'invalid - invalid',
'2023-01-01 / 2023-02-01',
'2023-01-01 2023-02-01',
'2023-01-01 - 2023-02-01 - 2023-02-01',
])('ignore invalid values', async (val) => {
await client.fetchTracesAnalytics({
filters: {
period: [{ operator: '=', value: val }],
},
});
expect(getQueryParam()).not.toContain('start_time=');
expect(getQueryParam()).not.toContain('end_time=');
expect(getQueryParam()).not.toContain('period=');
});
});
it('handles repeated params', async () => {
await client.fetchTracesAnalytics({
filters: {
operation: [
{ operator: '=', value: 'op' },
{ operator: '=', value: 'op2' },
],
},
});
expect(getQueryParam()).toContain('operation=op&operation=op2');
});
it('ignores unsupported filters', async () => {
await client.fetchTracesAnalytics({
filters: {
unsupportedFilter: [{ operator: '=', value: 'foo' }],
},
});
expect(getQueryParam()).toBe(``);
});
it('ignores empty filters', async () => {
await client.fetchTracesAnalytics({
filters: {
durationMs: null,
},
});
expect(getQueryParam()).toBe(``);
});
it('ignores non-array filters', async () => {
await client.fetchTracesAnalytics({
filters: {
traceId: { operator: '=', value: 'foo' },
},
});
expect(getQueryParam()).toBe(``);
});
it('ignores unsupported operators', async () => {
await client.fetchTracesAnalytics({
filters: {
durationMs: [
{ operator: '*', value: 'foo' },
{ operator: '=', value: 'foo' },
{ operator: '!=', value: 'foo' },
],
operation: [
{ operator: '>', value: 'foo' },
{ operator: '<', value: 'foo' },
],
service: [
{ operator: '>', value: 'foo' },
{ operator: '<', value: 'foo' },
],
period: [{ operator: '!=', value: 'foo' }],
traceId: [
{ operator: '>', value: 'foo' },
{ operator: '<', value: 'foo' },
],
},
});
expect(getQueryParam()).toBe(``);
});
});
});
describe('fetchServices', () => {
it('fetches services from the services URL', async () => {
const mockResponse = {
services: [{ name: 'service-1' }, { name: 'service-2' }],
};
axiosMock.onGet(servicesUrl).reply(200, mockResponse);
const result = await client.fetchServices();
expect(axios.get).toHaveBeenCalledTimes(1);
expect(axios.get).toHaveBeenCalledWith(servicesUrl, {
withCredentials: true,
});
expect(result).toEqual(mockResponse.services);
});
it('rejects if services are missing', async () => {
axiosMock.onGet(servicesUrl).reply(200, {});
const e = 'failed to fetch services. invalid response';
await expect(client.fetchServices()).rejects.toThrow(e);
expectErrorToBeReported(new Error(e));
});
});
describe('fetchOperations', () => {
const serviceName = 'test-service';
const parsedOperationsUrl = `https://example.com/services/${serviceName}/operations`;
it('fetches operations from the operations URL', async () => {
const mockResponse = {
operations: [{ name: 'operation-1' }, { name: 'operation-2' }],
};
axiosMock.onGet(parsedOperationsUrl).reply(200, mockResponse);
const result = await client.fetchOperations(serviceName);
expect(axios.get).toHaveBeenCalledTimes(1);
expect(axios.get).toHaveBeenCalledWith(parsedOperationsUrl, {
withCredentials: true,
});
expect(result).toEqual(mockResponse.operations);
});
it('rejects if serviceName is missing', async () => {
const e = 'fetchOperations() - serviceName is required.';
await expect(client.fetchOperations()).rejects.toThrow(e);
expectErrorToBeReported(new Error(e));
});
it('rejects if operationUrl does not contain $SERVICE_NAME$', async () => {
client = buildClient({
...apiConfig,
operationsUrl: 'something',
});
const e = 'fetchOperations() - operationsUrl must contain $SERVICE_NAME$';
await expect(client.fetchOperations(serviceName)).rejects.toThrow(e);
expectErrorToBeReported(new Error(e));
});
it('rejects if operations are missing', async () => {
axiosMock.onGet(parsedOperationsUrl).reply(200, {});
const e = 'failed to fetch operations. invalid response';
await expect(client.fetchOperations(serviceName)).rejects.toThrow(e);
expectErrorToBeReported(new Error(e));
});
});
describe('fetchMetrics', () => {
const FETCHING_METRICS_ERROR = 'metrics are missing/invalid in the response';
it('fetches metrics from the metrics URL', async () => {
const mockResponse = {
metrics: [
{
name: 'metric A',
description: 'a counter metric called A',
type: 'COUNTER',
attributes: [],
},
{
name: 'metric B',
description: 'a gauge metric called B',
type: 'GAUGE',
attributes: [],
},
],
};
axiosMock.onGet(metricsUrl).reply(200, mockResponse);
const result = await client.fetchMetrics();
expect(axios.get).toHaveBeenCalledTimes(1);
expect(axios.get).toHaveBeenCalledWith(metricsUrl, {
withCredentials: true,
params: expect.any(URLSearchParams),
});
expect(result).toEqual(mockResponse);
});
describe('query filter', () => {
beforeEach(() => {
axiosMock.onGet(metricsUrl).reply(200, {
metrics: [],
});
});
it('does not set any query param without filters', async () => {
await client.fetchMetrics();
expect(getQueryParam()).toBe('');
});
it('sets the start_with query param based on the search filter', async () => {
await client.fetchMetrics({
filters: { search: [{ value: 'foo' }, { value: 'bar' }, { value: ' ' }] },
});
expect(getQueryParam()).toBe('search=foo+bar');
});
it('ignores empty search', async () => {
await client.fetchMetrics({
filters: {
search: [{ value: ' ' }, { value: '' }, { value: null }, { value: undefined }],
},
});
expect(getQueryParam()).toBe('');
});
it('ignores unsupported filters', async () => {
await client.fetchMetrics({
filters: {
unsupportedFilter: [{ operator: '=', value: 'foo' }],
},
});
expect(getQueryParam()).toBe('');
});
it('ignores non-array search filters', async () => {
await client.fetchMetrics({
filters: {
search: { value: 'foo' },
},
});
expect(getQueryParam()).toBe('');
});
it('adds the search limit param if specified with the search filter', async () => {
await client.fetchMetrics({
filters: { search: [{ value: 'foo' }] },
limit: 50,
});
expect(getQueryParam()).toBe('search=foo&limit=50');
});
it('does not add the search limit param if the search filter is missing', async () => {
await client.fetchMetrics({
limit: 50,
});
expect(getQueryParam()).toBe('');
});
it('does not add the search limit param if the search filter is empty', async () => {
await client.fetchMetrics({
limit: 50,
search: [{ value: ' ' }, { value: '' }, { value: null }, { value: undefined }],
});
expect(getQueryParam()).toBe('');
});
});
it('rejects if metrics are missing', async () => {
axiosMock.onGet(metricsUrl).reply(200, {});
await expect(client.fetchMetrics()).rejects.toThrow(FETCHING_METRICS_ERROR);
expectErrorToBeReported(new Error(FETCHING_METRICS_ERROR));
});
it('rejects if metrics are invalid', async () => {
axiosMock.onGet(metricsUrl).reply(200, { traces: 'invalid' });
await expect(client.fetchMetrics()).rejects.toThrow(FETCHING_METRICS_ERROR);
expectErrorToBeReported(new Error(FETCHING_METRICS_ERROR));
});
});
describe('fetchMetric', () => {
it('fetches the metric from the API', async () => {
const data = { results: [] };
axiosMock.onGet(metricsSearchUrl).reply(200, data);
const result = await client.fetchMetric('name', 'type');
expect(axios.get).toHaveBeenCalledTimes(1);
expect(axios.get).toHaveBeenCalledWith(metricsSearchUrl, {
withCredentials: true,
params: new URLSearchParams({ mname: 'name', mtype: 'type' }),
});
expect(result).toEqual(data.results);
});
it('passes the abort controller to axios', async () => {
axiosMock.onGet(metricsSearchUrl).reply(200, { results: [] });
const abortController = new AbortController();
await client.fetchMetric('name', 'type', { abortController });
expect(axios.get).toHaveBeenCalledWith(metricsSearchUrl, {
withCredentials: true,
params: new URLSearchParams({ mname: 'name', mtype: 'type' }),
signal: abortController.signal,
});
});
describe('query filter params', () => {
beforeEach(() => {
axiosMock.onGet(metricsSearchUrl).reply(200, { results: [] });
});
describe('attribute filter', () => {
it('converts filter to proper query params', async () => {
await client.fetchMetric('name', 'type', {
filters: {
attributes: {
attr_1: [
{ operator: '=', value: 'foo' },
{ operator: '!=', value: 'bar' },
],
attr_2: [
{ operator: '=~', value: 'foo' },
{ operator: '!~', value: 'bar' },
],
},
},
});
expect(getQueryParam()).toBe(
'mname=name&mtype=type' +
'&attrs=attr_1,eq,foo' +
'&attrs=attr_1,neq,bar' +
'&attrs=attr_2,re,foo' +
'&attrs=attr_2,nre,bar',
);
});
it('ignores empty filters', async () => {
await client.fetchMetric('name', 'type', {
filters: { attributes: [] },
});
expect(getQueryParam()).toBe('mname=name&mtype=type');
});
it('ignores undefined dimension filters', async () => {
await client.fetchMetric('name', 'type', {
filters: { attributes: undefined },
});
expect(getQueryParam()).toBe('mname=name&mtype=type');
});
it('ignores non-array filters', async () => {
await client.fetchMetric('name', 'type', {
filters: {
attributes: {
attr_1: { operator: '=', value: 'foo' },
},
},
});
expect(getQueryParam()).toBe('mname=name&mtype=type');
});
it('ignores unsupported operators', async () => {
await client.fetchMetric('name', 'type', {
filters: {
attributes: {
attr_1: [
{ operator: '*', value: 'foo' },
{ operator: '>', value: 'foo' },
{ operator: '<', value: 'foo' },
],
},
},
});
expect(getQueryParam()).toBe('mname=name&mtype=type');
});
it('ignores undefined filters', async () => {
await client.fetchMetric('name', 'type', {
filters: undefined,
});
expect(getQueryParam()).toBe('mname=name&mtype=type');
});
it('ignores null filters', async () => {
await client.fetchMetric('name', 'type', {
filters: null,
});
expect(getQueryParam()).toBe('mname=name&mtype=type');
});
});
describe('date range filter', () => {
it('handle predefined date range value', async () => {
await client.fetchMetric('name', 'type', {
filters: { dateRange: { value: '5m' } },
});
expect(getQueryParam()).toContain(`period=5m`);
});
it('handle custom date range value', async () => {
await client.fetchMetric('name', 'type', {
filters: {
dateRange: {
endDate: new Date('2020-07-06'),
startDate: new Date('2020-07-05'),
value: 'custom',
},
},
});
expect(getQueryParam()).toContain(
'start_time=2020-07-05T00:00:00.000Z&end_time=2020-07-06T00:00:00.000Z',
);
});
});
it('ignores empty filter', async () => {
await client.fetchMetric('name', 'type', {
filters: { dateRange: {} },
});
expect(getQueryParam()).toBe('mname=name&mtype=type');
});
it('ignores undefined filter', async () => {
await client.fetchMetric('name', 'type', {
filters: { dateRange: undefined },
});
expect(getQueryParam()).toBe('mname=name&mtype=type');
});
describe('group by filter', () => {
it('handle group by func', async () => {
await client.fetchMetric('name', 'type', {
filters: { groupBy: { func: 'sum' } },
});
expect(getQueryParam()).toContain(`groupby_fn=sum`);
});
it('handle group by attribute', async () => {
await client.fetchMetric('name', 'type', {
filters: { groupBy: { attributes: ['attr_1'] } },
});
expect(getQueryParam()).toContain(`groupby_attrs=attr_1`);
});
it('handle group by multiple attributes', async () => {
await client.fetchMetric('name', 'type', {
filters: { groupBy: { attributes: ['attr_1', 'attr_2'] } },
});
expect(getQueryParam()).toContain(`groupby_attrs=attr_1,attr_2`);
});
it('ignores empty filter', async () => {
await client.fetchMetric('name', 'type', {
filters: { groupBy: {} },
});
expect(getQueryParam()).toBe('mname=name&mtype=type');
});
it('ignores empty list', async () => {
await client.fetchMetric('name', 'type', {
filters: { groupBy: { attributes: [] } },
});
expect(getQueryParam()).toBe('mname=name&mtype=type');
});
it('ignores undefined filter', async () => {
await client.fetchMetric('name', 'type', {
filters: { groupBy: undefined },
});
expect(getQueryParam()).toBe('mname=name&mtype=type');
});
});
});
it('rejects if results is missing from the response', async () => {
axiosMock.onGet(metricsSearchUrl).reply(200, {});
const e = 'metrics are missing/invalid in the response';
await expect(client.fetchMetric('name', 'type')).rejects.toThrow(e);
expectErrorToBeReported(new Error(e));
});
it('rejects if metric name is missing', async () => {
const e = 'fetchMetric() - metric name is required.';
await expect(client.fetchMetric()).rejects.toThrow(e);
expectErrorToBeReported(new Error(e));
});
it('rejects if metric type is missing', async () => {
const e = 'fetchMetric() - metric type is required.';
await expect(client.fetchMetric('name')).rejects.toThrow(e);
expectErrorToBeReported(new Error(e));
});
});
describe('fetchMetricSearchMetadata', () => {
it('fetches the metric metadata from the API', async () => {
const data = {
name: 'system.network.packets',
type: 'sum',
description: 'System network packets',
attribute_keys: ['device', 'direction'],
last_ingested_at: 1706338215873651200,
supported_aggregations: ['1m', '1h', '1d'],
supported_functions: ['avg', 'sum', 'min', 'max', 'count'],
default_group_by_attributes: ['*'],
default_group_by_function: 'sum',
};
axiosMock.onGet(metricsSearchMetadataUrl).reply(200, data);
const result = await client.fetchMetricSearchMetadata('name', 'type');
expect(axios.get).toHaveBeenCalledTimes(1);
expect(axios.get).toHaveBeenCalledWith(metricsSearchMetadataUrl, {
withCredentials: true,
params: new URLSearchParams({ mname: 'name', mtype: 'type' }),
});
expect(result).toEqual(data);
});
});
describe('fetchLogs', () => {
const mockResponse = {
results: [
{
timestamp: '2024-01-28T10:36:08.2960655Z',
trace_id: 'trace-id',
span_id: 'span-id',
trace_flags: 1,
severity_text: 'Information',
severity_number: 1,
service_name: 'a/service/name',
body: 'GetCartAsync called with userId={userId} ',
resource_attributes: {
'container.id': '8aae63236c224245383acd38611a4e32d09b7630573421fcc801918eda378bf5',
'k8s.deployment.name': 'otel-demo-cartservice',
'k8s.namespace.name': 'otel-demo-app',
},
log_attributes: {
userId: '',
},
},
],
next_page_token: 'test-token',
};
const FETCHING_LOGS_ERROR = 'logs are missing/invalid in the response';
beforeEach(() => {
axiosMock.onGet(logsSearchUrl).reply(200, mockResponse);
});
it('fetches logs from the logs URL', async () => {
const result = await client.fetchLogs();
expect(axios.get).toHaveBeenCalledTimes(1);
expect(axios.get).toHaveBeenCalledWith(logsSearchUrl, {
withCredentials: true,
params: expect.any(URLSearchParams),
});
expect(result).toEqual({
logs: mockResponse.results,
nextPageToken: mockResponse.next_page_token,
});
});
it('appends page_token if specified', async () => {
await client.fetchLogs({ pageToken: 'page-token' });
expect(getQueryParam()).toContain('page_token=page-token');
});
it('appends page_size if specified', async () => {
await client.fetchLogs({ pageSize: 10 });
expect(getQueryParam()).toContain('page_size=10');
});
it('rejects if logs are missing', async () => {
axiosMock.onGet(logsSearchUrl).reply(200, {});
await expect(client.fetchLogs()).rejects.toThrow(FETCHING_LOGS_ERROR);
expectErrorToBeReported(new Error(FETCHING_LOGS_ERROR));
});
it('rejects if logs are invalid', async () => {
axiosMock.onGet(logsSearchUrl).reply(200, { results: 'invalid' });
await expect(client.fetchLogs()).rejects.toThrow(FETCHING_LOGS_ERROR);
expectErrorToBeReported(new Error(FETCHING_LOGS_ERROR));
});
describe('filters', () => {
describe('date range filter', () => {
it('handle predefined date range value', async () => {
await client.fetchLogs({
filters: { dateRange: { value: '5m' } },
});
expect(getQueryParam()).toContain(`period=5m`);
});
it('handle custom date range value', async () => {
await client.fetchLogs({
filters: {
dateRange: {
endDate: new Date('2020-07-06'),
startDate: new Date('2020-07-05'),
value: 'custom',
},
},
});
expect(getQueryParam()).toContain(
'start_time=2020-07-05T00:00:00.000Z&end_time=2020-07-06T00:00:00.000Z',
);
});
});
it('ignores empty filter', async () => {
await client.fetchLogs({
filters: { dateRange: {} },
});
expect(getQueryParam()).toBe('');
});
it('ignores undefined filter', async () => {
await client.fetchLogs({
filters: { dateRange: undefined },
});
expect(getQueryParam()).toBe('');
});
});
});
});